# ISIS v2 Character Expression Sheet SDK End-to-End Examples

Generated: 2026-08-02T17:07:13.715Z Checklist: `MXA-0046` (ISIS2-00244) Asset
Family: `character-expression-sheet` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Expose character-expression-sheet 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                                                                |
| ------------------------------------------------ | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `character-expression-sheet-baseline`            | `text-to-image` | `character_archetype`, `style_preset`, `expression_set`, `expression_layout`, `emotion_intensity_profile`, `camera_framing`, `seed`                                                                                                                                                                                                                                           |                                                                                       |
| `character-expression-sheet-image-conditioned`   | `text-to-image` | `character_archetype`, `style_preset`, `expression_set`, `expression_layout`, `style_reference_image`, `seed`                                                                                                                                                                                                                                                                 |                                                                                       |
| `character-expression-sheet-control-conditioned` | `text-to-image` | `character_archetype`, `style_preset`, `expression_set`, `expression_layout`, `emotion_intensity_profile`, `seed`, `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` | `pose_map`, `depth_map`, `segmentation_map`, `normal_map`, `canny_map`, `lineart_map` |
| `character-expression-sheet-consistency-locked`  | `text-to-image` | `character_archetype`, `style_preset`, `expression_set`, `expression_layout`, `emotion_intensity_profile`, `seed`, `continuity_profile_id`, `continuity_profile_revision`, `identity_reference_image`, `identity_profile_id`, `style_profile_id`                                                                                                                              |                                                                                       |

## SDK Surface

- Workflow resource method `runCharacterExpressionSheet`: present
- Workflow resource method `runCharacterExpressionSheetBaseline`: present
- Workflow resource method `runCharacterExpressionSheetImageConditioned`:
  present
- Workflow resource method `runCharacterExpressionSheetControlConditioned`:
  present
- Workflow resource method `runCharacterExpressionSheetConsistencyLocked`:
  present
- Client shortcut `runCharacterExpressionSheetBaseline`: present
- Client shortcut `runCharacterExpressionSheetImageConditioned`: present
- Client shortcut `runCharacterExpressionSheetControlConditioned`: present
- Client shortcut `runCharacterExpressionSheetConsistencyLocked`: present
- Example helper `createCharacterExpressionSheetEndToEndExamples`: present
- Example helper `executeCharacterExpressionSheetEndToEndExamples`: present

## Verification Commands

- `pnpm --filter @isis/client exec vitest run src/resources/workflows.character-expression-sheet.spec.ts src/examples/character-expression-sheet.spec.ts`
- `pnpm nx build @isis/client`

## Acceptance Criteria

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

## Traceability

- Checklist item: `MXA-0046`
- Ticket key: `ISIS2-00244`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_EXPRESSION_SHEET_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_EXPRESSION_SHEET_GENERATION_API_TYPED_REQUEST_CONTRACTS.json`
  - `libs/isis/client/src/resources/workflows.ts`
  - `libs/isis/client/src/resources/workflows.character-expression-sheet.spec.ts`
  - `libs/isis/client/src/examples/character-expression-sheet.ts`
  - `libs/isis/client/src/examples/character-expression-sheet.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`
