# ISIS v2 Cinematic Shot Sequence SDK End-to-End Examples

Generated: 2026-08-02T19:12:19.355Z Checklist: `MXA-0478` (ISIS2-00676) Asset
Family: `cinematic-shot-sequence` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Expose cinematic-shot-sequence 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 Contracts

| Workflow ID                                   | Generation Type | Required Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Conditional Parameters                                                               |
| --------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| `cinematic-shot-sequence-baseline`            | `text-to-video` | `lens_mm`, `aspect_ratio`, `sequence_id`, `scene_description`, `shot_goal`, `camera_setup`, `camera_motion`, `style_preset`, `continuity_notes`, `duration_seconds`, `frame_rate`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                                                                                      |
| `cinematic-shot-sequence-image-conditioned`   | `text-to-video` | `style_reference_image`, `use_composition_reference`, `reference_strength`, `composition_strength`, `composition_rule`, `subject_blocking`, `environment_context`, `color_script`, `prompt_template_id`, `style_profile_id`, `lens_profile`, `sequence_id`, `scene_description`, `shot_goal`, `camera_setup`, `camera_motion`, `style_preset`, `continuity_notes`, `duration_seconds`, `frame_rate`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                                                                                                                                                                                                                                                                         |                                                                                      |
| `cinematic-shot-sequence-control-conditioned` | `text-to-video` | `use_pose_control`, `use_depth_control`, `use_segmentation_control`, `use_normal_control`, `use_canny_control`, `use_lineart_control`, `pose_strength`, `depth_strength`, `segmentation_strength`, `normal_strength`, `canny_strength`, `lineart_strength`, `composition_rule`, `subject_blocking`, `environment_context`, `color_script`, `prompt_template_id`, `style_profile_id`, `lens_profile`, `sequence_id`, `scene_description`, `shot_goal`, `camera_setup`, `camera_motion`, `style_preset`, `continuity_notes`, `duration_seconds`, `frame_rate`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                                                                                                                 | `pose_map`, `depth_map`, `segmentation_map`, `normal_map`, `edge_map`, `lineart_map` |
| `cinematic-shot-sequence-consistency-locked`  | `text-to-video` | `continuity_profile_id`, `continuity_profile_revision`, `continuity_locked_dimensions`, `scene_profile_id`, `style_profile_id`, `scene_anchor_reference_image`, `use_scene_anchor_reference`, `use_layout_reference`, `use_blocking_reference`, `use_lens_reference`, `use_style_lock`, `composition_rule`, `subject_blocking`, `environment_context`, `prompt_template_id`, `lens_mm`, `color_script`, `lens_profile`, `scene_anchor_lock_strength`, `layout_lock_strength`, `blocking_lock_strength`, `lens_lock_strength`, `style_lock_strength`, `sequence_id`, `scene_description`, `shot_goal`, `camera_setup`, `camera_motion`, `style_preset`, `continuity_notes`, `duration_seconds`, `frame_rate`, `seed`, `width`, `height`, `steps`, `cfg_scale` |                                                                                      |

## SDK Surface Checks

| Method Group    | Method                                         | Present |
| --------------- | ---------------------------------------------- | ------- |
| Workflow run    | `runCinematicShotSequence`                     | true    |
| Workflow run    | `runCinematicShotSequenceBaseline`             | true    |
| Workflow run    | `runCinematicShotSequenceImageConditioned`     | true    |
| Workflow run    | `runCinematicShotSequenceControlConditioned`   | true    |
| Workflow run    | `runCinematicShotSequenceConsistencyLocked`    | true    |
| Client shortcut | `runCinematicShotSequenceBaseline`             | true    |
| Client shortcut | `runCinematicShotSequenceImageConditioned`     | true    |
| Client shortcut | `runCinematicShotSequenceControlConditioned`   | true    |
| Client shortcut | `runCinematicShotSequenceConsistencyLocked`    | true    |
| Examples        | `createCinematicShotSequenceEndToEndExamples`  | true    |
| Examples        | `executeCinematicShotSequenceEndToEndExamples` | true    |

## Verification Commands

- `pnpm --filter @isis/client exec vitest run src/resources/workflows.cinematic-shot-sequence.spec.ts src/examples/cinematic-shot-sequence.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 cinematic-shot-sequence 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
  cinematic-shot-sequence workflow surface for downstream consumers.

## Traceability

- Checklist item: `MXA-0478`
- Ticket key: `ISIS2-00676`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CINEMATIC_SHOT_SEQUENCE_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CINEMATIC_SHOT_SEQUENCE_GENERATION_API_TYPED_REQUEST_CONTRACTS.json`
  - `libs/isis/client/src/resources/workflows.ts`
  - `libs/isis/client/src/resources/workflows.cinematic-shot-sequence.spec.ts`
  - `libs/isis/client/src/examples/cinematic-shot-sequence.ts`
  - `libs/isis/client/src/examples/cinematic-shot-sequence.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`
