# ISIS v2 Music Cue Pack SDK End-to-End Examples

Generated: 2026-03-03T17:22:19.552Z Checklist: `MXA-0568` (ISIS2-00766) Asset
Family: `music-cue-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Expose music-cue-pack workflows via @isis/client with typed SDK request
contracts and end-to-end example builders covering direct runs, chained
orchestration, and batch variants.

## Typed Workflow IDs

- `music-cue-pack-baseline`
- `music-cue-pack-consistency-locked`
- `music-cue-pack-control-conditioned`
- `music-cue-pack-image-conditioned`

## Typed SDK Contracts

| Workflow ID                          | Generation Type    | Required Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------ | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `music-cue-pack-baseline`            | `music-generation` | `conditioning_strength`, `cue_id`, `prompt`, `cue_purpose`, `mood`, `instrumentation`, `tempo_bpm`, `duration_seconds`, `key_signature`, `time_signature`, `sample_rate_hz`, `target_lufs`, `output_format`, `seed`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `music-cue-pack-image-conditioned`   | `music-generation` | `reference_audio_url`, `conditioning_strength`, `conditioning_mode`, `provider_capability_mode`, `reference_mix_strategy`, `preserve_prompt_intent`, `prompt_template_id`, `style_profile_id`, `model_name`, `cue_id`, `prompt`, `cue_purpose`, `mood`, `instrumentation`, `tempo_bpm`, `duration_seconds`, `key_signature`, `time_signature`, `sample_rate_hz`, `target_lufs`, `output_format`, `seed`                                                                                                                                                                                                                                                                                                                                                                                             |
| `music-cue-pack-control-conditioned` | `music-generation` | `use_pose_control`, `use_depth_control`, `use_segmentation_control`, `use_canny_control`, `use_lineart_control`, `pose_strength`, `depth_strength`, `segmentation_strength`, `canny_strength`, `lineart_strength`, `control_applicability_mode`, `control_signal_fusion`, `control_profile_id`, `control_timeline_fps`, `event_alignment_mode`, `prompt_template_id`, `style_profile_id`, `model_name`, `cue_id`, `prompt`, `cue_purpose`, `mood`, `instrumentation`, `tempo_bpm`, `duration_seconds`, `key_signature`, `time_signature`, `sample_rate_hz`, `target_lufs`, `output_format`, `seed`                                                                                                                                                                                                  |
| `music-cue-pack-consistency-locked`  | `music-generation` | `continuity_profile_id`, `continuity_profile_revision`, `continuity_locked_dimensions`, `continuity_notes`, `continuity_window_size`, `timbre_reference_audio_url`, `use_timbre_reference`, `use_cue_timing_reference`, `use_ambience_reference`, `use_spatial_reference`, `continuity_lock_strength`, `motif_lock_strength`, `cue_timing_lock_strength`, `ambience_lock_strength`, `spatial_lock_strength`, `cue_timing_alignment_target_score`, `motif_alignment_target_score`, `integrated_lufs_delta_tolerance`, `harmonic_drift_tolerance`, `prompt_template_id`, `style_profile_id`, `model_name`, `cue_id`, `prompt`, `cue_purpose`, `mood`, `instrumentation`, `tempo_bpm`, `duration_seconds`, `key_signature`, `time_signature`, `sample_rate_hz`, `target_lufs`, `output_format`, `seed` |

## SDK Surface Presence

| Surface   | Method                                | Present |
| --------- | ------------------------------------- | ------- |
| workflows | `runMusicCuePack`                     | true    |
| workflows | `runMusicCuePackBaseline`             | true    |
| workflows | `runMusicCuePackImageConditioned`     | true    |
| workflows | `runMusicCuePackControlConditioned`   | true    |
| workflows | `runMusicCuePackConsistencyLocked`    | true    |
| client    | `runMusicCuePackBaseline`             | true    |
| client    | `runMusicCuePackImageConditioned`     | true    |
| client    | `runMusicCuePackControlConditioned`   | true    |
| client    | `runMusicCuePackConsistencyLocked`    | true    |
| examples  | `createMusicCuePackEndToEndExamples`  | true    |
| examples  | `executeMusicCuePackEndToEndExamples` | true    |

## Verification Commands

- `pnpm --filter @isis/client exec vitest run src/resources/workflows.music-cue-pack.spec.ts src/examples/music-cue-pack.spec.ts`
- `pnpm --filter @isis/client exec vitest run src/resources/workflows.route-parity.spec.ts`

## Acceptance Criteria

- SDK exposes typed run methods for baseline, image-conditioned,
  control-conditioned, and consistency-locked music-cue-pack workflows.
- SDK runtime validation rejects invalid generation types and malformed variant
  parameters before transport dispatch.
- SDK exports end-to-end examples for direct runs plus chain and batch
  orchestration payloads.
- SDK root exports and client shortcut methods expose the music-cue-pack
  workflow surface for downstream consumers.

## Traceability

- Checklist item: `MXA-0568`
- Ticket key: `ISIS2-00766`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_GENERATION_API_TYPED_REQUEST_CONTRACTS.json`
  - `libs/isis/client/src/resources/workflows.ts`
  - `libs/isis/client/src/resources/workflows.music-cue-pack.spec.ts`
  - `libs/isis/client/src/examples/music-cue-pack.ts`
  - `libs/isis/client/src/examples/music-cue-pack.spec.ts`
  - `libs/isis/client/src/client.ts`
  - `libs/isis/client/src/index.ts`
  - `libs/isis/client/src/resources/index.ts`
  - `ISIS_TODOS_2.md`
