Eve library

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

Guide

Revision 1

On this page

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