# ISIS v2 Audio SFX Pack SDK End-to-End Examples

Generated: 2026-08-02T19:12:26.744Z Checklist: `MXA-0532` (ISIS2-00730) Asset
Family: `audio-sfx-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Expose audio-sfx-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

- `audio-sfx-pack-baseline`
- `audio-sfx-pack-consistency-locked`
- `audio-sfx-pack-control-conditioned`
- `audio-sfx-pack-image-conditioned`

## Typed SDK Contracts

| Workflow ID                          | Generation Type | Required Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------------------------ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `audio-sfx-pack-baseline`            | `text-to-audio` | `conditioning_strength`, `cue_id`, `prompt`, `sfx_type`, `intensity`, `spatial_profile`, `duration_seconds`, `sample_rate_hz`, `target_lufs`, `output_format`, `seed`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `audio-sfx-pack-image-conditioned`   | `text-to-audio` | `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`, `sfx_type`, `intensity`, `spatial_profile`, `duration_seconds`, `sample_rate_hz`, `target_lufs`, `output_format`, `seed`                                                                                                                                                                                                                                                                                                                                                                                         |
| `audio-sfx-pack-control-conditioned` | `text-to-audio` | `use_pose_control`, `use_depth_control`, `use_segmentation_control`, `use_normal_control`, `use_canny_control`, `use_lineart_control`, `use_mask_region_guide`, `pose_strength`, `depth_strength`, `segmentation_strength`, `normal_strength`, `canny_strength`, `lineart_strength`, `mask_guide_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`, `sfx_type`, `intensity`, `spatial_profile`, `duration_seconds`, `sample_rate_hz`, `target_lufs`, `output_format`, `seed`                                                                                                     |
| `audio-sfx-pack-consistency-locked`  | `text-to-audio` | `continuity_profile_id`, `continuity_profile_revision`, `continuity_locked_dimensions`, `continuity_notes`, `continuity_window_size`, `timbre_reference_audio_url`, `use_timbre_reference`, `use_transient_reference`, `use_ambience_reference`, `use_spatial_reference`, `continuity_lock_strength`, `timbral_lock_strength`, `transient_lock_strength`, `ambience_lock_strength`, `spatial_lock_strength`, `event_alignment_target_score`, `transient_clarity_target_score`, `integrated_lufs_delta_tolerance`, `timbral_drift_tolerance`, `prompt_template_id`, `style_profile_id`, `model_name`, `cue_id`, `prompt`, `sfx_type`, `intensity`, `spatial_profile`, `duration_seconds`, `sample_rate_hz`, `target_lufs`, `output_format`, `seed` |

## SDK Surface Presence

| Surface   | Method                                | Present |
| --------- | ------------------------------------- | ------- |
| workflows | `runAudioSfxPack`                     | true    |
| workflows | `runAudioSfxPackBaseline`             | true    |
| workflows | `runAudioSfxPackImageConditioned`     | true    |
| workflows | `runAudioSfxPackControlConditioned`   | true    |
| workflows | `runAudioSfxPackConsistencyLocked`    | true    |
| client    | `runAudioSfxPackBaseline`             | true    |
| client    | `runAudioSfxPackImageConditioned`     | true    |
| client    | `runAudioSfxPackControlConditioned`   | true    |
| client    | `runAudioSfxPackConsistencyLocked`    | true    |
| examples  | `createAudioSfxPackEndToEndExamples`  | true    |
| examples  | `executeAudioSfxPackEndToEndExamples` | true    |

## Verification Commands

- `pnpm --filter @isis/client exec vitest run src/resources/workflows.audio-sfx-pack.spec.ts src/examples/audio-sfx-pack.spec.ts`
- `pnpm --filter @isis/client exec tsup`

## Acceptance Criteria

- SDK exposes typed run methods for baseline, image-conditioned,
  control-conditioned, and consistency-locked audio-sfx-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 audio-sfx-pack
  workflow surface for downstream consumers.

## Traceability

- Checklist item: `MXA-0532`
- Ticket key: `ISIS2-00730`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_AUDIO_SFX_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_AUDIO_SFX_PACK_GENERATION_API_TYPED_REQUEST_CONTRACTS.json`
  - `libs/isis/client/src/resources/workflows.ts`
  - `libs/isis/client/src/resources/workflows.audio-sfx-pack.spec.ts`
  - `libs/isis/client/src/examples/audio-sfx-pack.ts`
  - `libs/isis/client/src/examples/audio-sfx-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`
