# ISIS v2 Terrain Heightmap Pack SDK End-to-End Examples

Generated: 2026-08-02T18:14:04.821Z Checklist: `MXA-0370` (ISIS2-00568) Asset
Family: `terrain-heightmap-pack` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Expose terrain-heightmap-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 Contracts

| Workflow ID                                  | Generation Type | Required Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| -------------------------------------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `terrain-heightmap-pack-baseline`            | `text-to-image` | `terrain_theme`, `biome_context`, `macro_landform_profile`, `terrain_scope`, `tileable_axes`, `seam_blend_strategy`, `ridge_transition_profile`, `heightmap_resolution_class`, `heightfield_density_class`, `erosion_material_profile`, `hydrology_profile`, `color_palette_profile`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `terrain-heightmap-pack-image-conditioned`   | `text-to-image` | `style_reference_image`, `use_composition_reference`, `reference_strength`, `composition_strength`, `height_output_mode`, `elevation_range_profile`, `prompt_template_id`, `style_profile_id`, `color_script`, `lens_profile`, `terrain_theme`, `biome_context`, `macro_landform_profile`, `terrain_scope`, `tileable_axes`, `seam_blend_strategy`, `ridge_transition_profile`, `heightmap_resolution_class`, `heightfield_density_class`, `erosion_material_profile`, `hydrology_profile`, `color_palette_profile`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                                                                                                                                                                                                                             |
| `terrain-heightmap-pack-control-conditioned` | `text-to-image` | `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`, `height_output_mode`, `elevation_range_profile`, `prompt_template_id`, `style_profile_id`, `color_script`, `lens_profile`, `terrain_theme`, `biome_context`, `macro_landform_profile`, `terrain_scope`, `tileable_axes`, `seam_blend_strategy`, `ridge_transition_profile`, `heightmap_resolution_class`, `heightfield_density_class`, `erosion_material_profile`, `hydrology_profile`, `color_palette_profile`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                     |
| `terrain-heightmap-pack-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_hydrology_reference`, `use_lens_reference`, `use_style_lock`, `height_output_mode`, `elevation_range_profile`, `focal_length_mm`, `scene_anchor_lock_strength`, `layout_lock_strength`, `hydrology_lock_strength`, `lens_lock_strength`, `style_lock_strength`, `terrain_theme`, `biome_context`, `macro_landform_profile`, `terrain_scope`, `tileable_axes`, `seam_blend_strategy`, `ridge_transition_profile`, `heightmap_resolution_class`, `heightfield_density_class`, `erosion_material_profile`, `hydrology_profile`, `color_palette_profile`, `seed`, `width`, `height`, `steps`, `cfg_scale` |

## SDK Surface Checks

| Category          | Method                                        | Present |
| ----------------- | --------------------------------------------- | ------- |
| workflow-resource | `runTerrainHeightmapPack`                     | true    |
| workflow-resource | `runTerrainHeightmapPackBaseline`             | true    |
| workflow-resource | `runTerrainHeightmapPackImageConditioned`     | true    |
| workflow-resource | `runTerrainHeightmapPackControlConditioned`   | true    |
| workflow-resource | `runTerrainHeightmapPackConsistencyLocked`    | true    |
| client-shortcut   | `runTerrainHeightmapPackBaseline`             | true    |
| client-shortcut   | `runTerrainHeightmapPackImageConditioned`     | true    |
| client-shortcut   | `runTerrainHeightmapPackControlConditioned`   | true    |
| client-shortcut   | `runTerrainHeightmapPackConsistencyLocked`    | true    |
| examples-module   | `createTerrainHeightmapPackEndToEndExamples`  | true    |
| examples-module   | `executeTerrainHeightmapPackEndToEndExamples` | true    |

## Verification Commands

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

## Traceability

- Checklist item: `MXA-0370`
- Ticket key: `ISIS2-00568`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_GENERATION_API_TYPED_REQUEST_CONTRACTS.json`
  - `libs/isis/client/src/resources/workflows.ts`
  - `libs/isis/client/src/resources/workflows.terrain-heightmap-pack.spec.ts`
  - `libs/isis/client/src/examples/terrain-heightmap-pack.ts`
  - `libs/isis/client/src/examples/terrain-heightmap-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`
