Scope#
WS09-002 provisions dedicated desired-state endpoint families for:
- character consistency
- cinematic video
- 3D workloads
- texture workloads
- audio lanes (continued coverage)
across both production and staging RunPod environments.
Research and Existing Implementation Alignment#
Pre-existing baseline:
- audio-dedicated lanes were already present from
WS08-008 - provider compatibility/routing contracts existed for
comfyui,sd,flux, and audio families - desired-state inventory did not yet include dedicated families for character, cinematic video, 3D, and texture lanes
Implementation was extended from these existing contracts rather than creating a parallel routing model.
Deliverables#
- Desired-state endpoint families
- Updated
infra/runpod/endpoints/desired-state.jsonwith dedicated endpoint entries for production and staging:character-consistencycinematic-videothree-dtexture
- Feature-flag and runtime config contracts
- Added endpoint ID and canary routing feature flags in
libs/shared/config/src/features.tsfor all new families. - Extended
getRunPodConfig()andvalidateRunPodConfiguration()to include new family contracts and canary validation. - Extended config tests in
libs/shared/config/src/features.spec.ts.
- Generation API routing and compatibility contracts
- Extended
RunPodEndpointFamilyand endpoint support matrix inapps/isis/generation-api/src/routes/jobs.ts. - Added dedicated generation-type support declarations for new families.
- Wired endpoint IDs and canary routing resolution for new families.
- Extended provider compatibility tests in
apps/isis/generation-api/src/routes/jobs.spec.ts.
- SDK/web exposure updates
- Extended client type contracts (
libs/isis/client/src/types.ts) so endpoint IDs/canary mappings and compatibility enums include new families. - Updated RunPod and Feature Flags UI family lists:
apps/isis/web/src/pages/RunPodPage.tsxapps/isis/web/src/pages/FeatureFlagsPage.tsx
- Updated corresponding page tests and RunPod parity fixtures.
- Infrastructure documentation updates
- Expanded
docs/infrastructure/runpod-integration.mdendpoint inventory and endpoint ID variable list to include new dedicated families.
Verification Commands#
bash
python3 scripts/isis/validate_runpod_desired_state.py --file infra/runpod/endpoints/desired-state.json
pnpm --filter @oshun/config exec vitest run src/features.spec.ts --reporter=dot
pnpm --filter @isis/generation-api exec vitest run src/routes/jobs.spec.ts --reporter=dot
pnpm --filter @isis/web exec vitest run src/pages/RunPodPage.spec.tsx src/pages/FeatureFlagsPage.spec.tsx src/pages/RunPodParityPage.spec.tsx --reporter=dot
node scripts/isis/generate-remediation-backlog-v2.mjs
node scripts/isis/validate-v2-compliance-gate.mjs
Result#
WS09-002 now provides dedicated endpoint family contracts across
desired-state, config, API, SDK, and web diagnostics for character consistency,
cinematic video, 3D, texture, and audio routing lanes.