Eve library

ISIS v2 Storyboard Frame Set Cost Estimation and Budget Guardrails

Guide

Revision 1

On this page

Generated: 2026-08-02T19:12:16.417Z Checklist: MXA-0446 (ISIS2-00644) Asset Family: storyboard-frame-set Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Deliver deterministic per-run cost/runtime estimation and threshold-based budget guardrails for storyboard-frame-set workflow execution, with enforcement and observability integrated into workflow run APIs and provider compatibility diagnostics.

Workflow Coverage#

Workflow Cost Utils Jobs Strategy Workflows Surface Sizing Policy
storyboard-frame-set-baseline true true false storyboard-frame-set-flux-standard
storyboard-frame-set-image-conditioned true true false storyboard-frame-set-flux-standard
storyboard-frame-set-control-conditioned true true true storyboard-frame-set-control-conditioned
storyboard-frame-set-consistency-locked true true true storyboard-frame-set-consistency-locked

Guardrail Environment-Key Coverage#

Env Key Cost Utils Jobs Strategy
ISIS_STORYBOARD_FRAME_SET_BUDGET_GUARDRAIL_ENABLED true true
ISIS_STORYBOARD_FRAME_SET_BUDGET_SOFT_LIMIT_USD true true
ISIS_STORYBOARD_FRAME_SET_BUDGET_HARD_LIMIT_USD true true
ISIS_STORYBOARD_FRAME_SET_RUNTIME_SOFT_LIMIT_SECONDS true true
ISIS_STORYBOARD_FRAME_SET_RUNTIME_HARD_LIMIT_SECONDS true true
ISIS_STORYBOARD_FRAME_SET_BUDGET_RETRY_AFTER_SECONDS true true
ISIS_STORYBOARD_FRAME_SET_COST_RATE_FLUX_USD_PER_SECOND true true
ISIS_STORYBOARD_FRAME_SET_COST_RATE_CHARACTER_CONSISTENCY_USD_PER_SECOND true true

Implementation Signals#

  • Cost utility methods:
    • estimateStoryboardFrameSetRunCost: present
    • evaluateStoryboardFrameSetBudgetGuardrail: present
    • applyStoryboardFrameSetBudgetGuardrailHeaders: present
  • Workflows route signals:
    • budgetGuardrailErrorClassImported: true
    • budgetGuardrailHeadersApplied: true
    • budgetGuardrailErrorCodeExposed: true
    • estimatedCostInWorkflowResponse: true
    • budgetMetadataStoredOnJob: true
  • Jobs route signals:
    • costEstimationProfilesExposed: true
    • budgetGuardrailsExposed: true
    • storyboardFrameSetPolicyConstantPresent: true
  • Test coverage signals:
    • costUtilsSpecAssertions: 4
    • workflowsSpecBudgetGuardrailAssertionPresent: true
    • jobsSpecCompatibilityAssertionPresent: true

Verification#

  • pnpm --filter @isis/generation-api exec vitest run src/routes/storyboard-frame-set-budget-utils.spec.ts src/routes/workflows.spec.ts src/routes/jobs.spec.ts

Acceptance Criteria#

  • storyboard-frame-set workflow variants return deterministic estimated runtime/cost signals before dispatch.
  • Budget guardrail thresholds enforce hard-fail rejection when estimated runtime/cost envelopes exceed configured limits.
  • Workflow run responses and headers expose estimation and guardrail diagnostics for operator visibility and downstream tooling.
  • Provider compatibility diagnostics expose storyboard-frame-set cost estimation profiles and budget guardrail policy metadata.

References#

  • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
  • docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_REQUIREMENTS_BRIEF.json
  • docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_RUNPOD_ENDPOINT_CLASS_SIZING_POLICIES.json
  • apps/isis/generation-api/src/routes/workflows.ts
  • apps/isis/generation-api/src/routes/workflows.spec.ts
  • apps/isis/generation-api/src/routes/jobs.ts
  • apps/isis/generation-api/src/routes/jobs.spec.ts
  • apps/isis/generation-api/src/routes/storyboard-frame-set-budget-utils.ts
  • apps/isis/generation-api/src/routes/storyboard-frame-set-budget-utils.spec.ts
  • ISIS_TODOS_2.md