# ISIS v2 Material PBR Pack SDK End-to-End Examples

Generated: 2026-08-02T16:03:34.672Z Checklist: `MXA-0334` (ISIS2-00532) Asset
Family: `material-pbr-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Expose material-pbr-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                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `material-pbr-pack-baseline`            | `text-to-image` | `material_category`, `material_subtype`, `surface_age_profile`, `albedo_palette_profile`, `roughness_profile`, `metallic_profile`, `normal_intensity_profile`, `microdetail_profile`, `macro_pattern_scale`, `tileability_mode`, `uv_repeat_target`, `displacement_intent`, `render_lighting_context`, `platform_target`, `render_intent`, `checkpoint_id`, `prompt_template_id`, `style_profile_id`, `color_script`, `lens_profile`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `material-pbr-pack-image-conditioned`   | `text-to-image` | `style_reference_image`, `use_composition_reference`, `reference_strength`, `composition_strength`, `material_finish_preset`, `material_category`, `material_subtype`, `surface_age_profile`, `albedo_palette_profile`, `roughness_profile`, `metallic_profile`, `normal_intensity_profile`, `microdetail_profile`, `macro_pattern_scale`, `tileability_mode`, `uv_repeat_target`, `displacement_intent`, `render_lighting_context`, `platform_target`, `render_intent`, `checkpoint_id`, `prompt_template_id`, `style_profile_id`, `color_script`, `lens_profile`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                                                                                                                                                                                                                                                                                                                                                                 |
| `material-pbr-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`, `material_control_preset`, `material_category`, `material_subtype`, `surface_age_profile`, `albedo_palette_profile`, `roughness_profile`, `metallic_profile`, `normal_intensity_profile`, `microdetail_profile`, `macro_pattern_scale`, `tileability_mode`, `uv_repeat_target`, `displacement_intent`, `render_lighting_context`, `platform_target`, `render_intent`, `checkpoint_id`, `prompt_template_id`, `style_profile_id`, `color_script`, `lens_profile`, `seed`, `width`, `height`, `steps`, `cfg_scale`                                                                                                                                                                                        |
| `material-pbr-pack-consistency-locked`  | `text-to-image` | `continuity_profile_id`, `continuity_profile_revision`, `continuity_locked_dimensions`, `material_scene_profile_id`, `style_profile_id`, `checkpoint_id`, `prompt_template_id`, `color_script`, `lens_profile`, `material_anchor_reference_image`, `use_material_anchor_reference`, `use_roughness_reference`, `use_normal_reference`, `use_lens_reference`, `use_style_lock`, `material_category`, `material_subtype`, `surface_age_profile`, `albedo_palette_profile`, `roughness_profile`, `metallic_profile`, `normal_intensity_profile`, `microdetail_profile`, `macro_pattern_scale`, `tileability_mode`, `uv_repeat_target`, `displacement_intent`, `render_lighting_context`, `texture_resolution_tier`, `channel_pack_profile`, `seam_suppression_profile`, `material_finish_preset`, `platform_target`, `render_intent`, `seed`, `width`, `height`, `steps`, `cfg_scale`, `material_anchor_lock_strength`, `roughness_lock_strength`, `normal_lock_strength`, `lens_lock_strength`, `style_lock_strength` |

## SDK Surface Checks

| Category          | Method                                   | Present |
| ----------------- | ---------------------------------------- | ------- |
| workflow-resource | `runMaterialPbrPack`                     | true    |
| workflow-resource | `runMaterialPbrPackBaseline`             | true    |
| workflow-resource | `runMaterialPbrPackImageConditioned`     | true    |
| workflow-resource | `runMaterialPbrPackControlConditioned`   | true    |
| workflow-resource | `runMaterialPbrPackConsistencyLocked`    | true    |
| client-shortcut   | `runMaterialPbrPackBaseline`             | true    |
| client-shortcut   | `runMaterialPbrPackImageConditioned`     | true    |
| client-shortcut   | `runMaterialPbrPackControlConditioned`   | true    |
| client-shortcut   | `runMaterialPbrPackConsistencyLocked`    | true    |
| examples-module   | `createMaterialPbrPackEndToEndExamples`  | true    |
| examples-module   | `executeMaterialPbrPackEndToEndExamples` | true    |

## Verification Commands

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

## Traceability

- Checklist item: `MXA-0334`
- Ticket key: `ISIS2-00532`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_GENERATION_API_TYPED_REQUEST_CONTRACTS.json`
  - `libs/isis/client/src/resources/workflows.ts`
  - `libs/isis/client/src/resources/workflows.material-pbr-pack.spec.ts`
  - `libs/isis/client/src/examples/material-pbr-pack.ts`
  - `libs/isis/client/src/examples/material-pbr-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`
