Eve library

ISIS v2 WS09-002: Dedicated RunPod Endpoint Families

Guide

Revision 1

On this page

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#

  1. Desired-state endpoint families
  • Updated infra/runpod/endpoints/desired-state.json with dedicated endpoint entries for production and staging:
    • character-consistency
    • cinematic-video
    • three-d
    • texture
  1. Feature-flag and runtime config contracts
  • Added endpoint ID and canary routing feature flags in libs/shared/config/src/features.ts for all new families.
  • Extended getRunPodConfig() and validateRunPodConfiguration() to include new family contracts and canary validation.
  • Extended config tests in libs/shared/config/src/features.spec.ts.
  1. Generation API routing and compatibility contracts
  • Extended RunPodEndpointFamily and endpoint support matrix in apps/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.
  1. 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.tsx
    • apps/isis/web/src/pages/FeatureFlagsPage.tsx
  • Updated corresponding page tests and RunPod parity fixtures.
  1. Infrastructure documentation updates
  • Expanded docs/infrastructure/runpod-integration.md endpoint 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.