# ISIS v2 Environment Matte Painting SDK End-to-End Examples

Generated: 2026-02-28T10:17:51.712Z Checklist: `MXA-0154` (ISIS2-00352) Asset
Family: `environment-matte-painting` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Expose environment-matte-painting 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                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------------------------------------------ | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `environment-matte-painting-baseline`            | `text-to-image` | `environment_type`, `biome_context`, `architectural_style`, `composition_profile`, `camera_framing`, `focal_length_mm`, `time_of_day`, `weather_system`, `lighting_mood`, `color_palette_profile`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `environment-matte-painting-image-conditioned`   | `text-to-image` | `style_reference_image`, `use_composition_reference`, `reference_strength`, `composition_strength`, `environment_type`, `biome_context`, `architectural_style`, `composition_profile`, `camera_framing`, `time_of_day`, `weather_system`, `lighting_mood`, `color_palette_profile`, `style_preset`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                                                                                                                                                                                                                                                                                                     |
| `environment-matte-painting-control-conditioned` | `text-to-image` | `use_pose_control`, `use_depth_control`, `use_segmentation_control`, `pose_strength`, `depth_strength`, `segmentation_strength`, `environment_type`, `biome_context`, `architectural_style`, `composition_profile`, `camera_framing`, `time_of_day`, `weather_system`, `lighting_mood`, `color_palette_profile`, `style_preset`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                                                                                                                                                                                                                                                                        |
| `environment-matte-painting-consistency-locked`  | `text-to-image` | `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_lighting_reference`, `use_lens_reference`, `use_style_lock`, `environment_type`, `biome_context`, `architectural_style`, `composition_profile`, `camera_framing`, `focal_length_mm`, `time_of_day`, `weather_system`, `lighting_mood`, `color_palette_profile`, `style_preset`, `seed`, `width`, `height`, `steps`, `cfg_scale`, `scene_anchor_lock_strength`, `layout_lock_strength`, `lighting_lock_strength`, `lens_lock_strength`, `style_lock_strength` |

## SDK Surface

- Workflow resource method `runEnvironmentMattePainting`: present
- Workflow resource method `runEnvironmentMattePaintingBaseline`: present
- Workflow resource method `runEnvironmentMattePaintingImageConditioned`:
  present
- Workflow resource method `runEnvironmentMattePaintingControlConditioned`:
  present
- Workflow resource method `runEnvironmentMattePaintingConsistencyLocked`:
  present
- Client shortcut `runEnvironmentMattePaintingBaseline`: present
- Client shortcut `runEnvironmentMattePaintingImageConditioned`: present
- Client shortcut `runEnvironmentMattePaintingControlConditioned`: present
- Client shortcut `runEnvironmentMattePaintingConsistencyLocked`: present
- Example helper `createEnvironmentMattePaintingEndToEndExamples`: present
- Example helper `executeEnvironmentMattePaintingEndToEndExamples`: present

## Verification Commands

- `pnpm --filter @isis/client exec vitest run src/resources/workflows.environment-matte-painting.spec.ts src/examples/environment-matte-painting.spec.ts`
- `pnpm nx build @isis/client`

## Acceptance Criteria

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

## Traceability

- Checklist item: `MXA-0154`
- Ticket key: `ISIS2-00352`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_MATTE_PAINTING_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_MATTE_PAINTING_GENERATION_API_TYPED_REQUEST_CONTRACTS.json`
  - `libs/isis/client/src/resources/workflows.ts`
  - `libs/isis/client/src/resources/workflows.environment-matte-painting.spec.ts`
  - `libs/isis/client/src/examples/environment-matte-painting.ts`
  - `libs/isis/client/src/examples/environment-matte-painting.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`
