Promote the four torch.compile kwargs the FastVideo-internal
ltx2-streaming gpu_pool hard-codes in its torch_compile_kwargs dict
into first-class typed fields on CompileConfig, and add a typed home
for ltx2_vae_tiling on PipelineSelection so PR 7.6's public gpu_pool
upstream has a typed boundary to hit.
Schema changes (fastvideo/api/schema.py):
CompileConfig:
- rename kwargs -> extras (breaking; pre-stable API)
- add backend: str | None (e.g. "inductor")
- add fullgraph: bool | None
- add mode: str | None (e.g. "max-autotune-no-cudagraphs")
- add dynamic: bool | None
extras still holds uncommon kwargs (e.g. options, disable).
PipelineSelection:
- add vae_tiling: bool | None. Shared across model families that
expose VAE tiling (LTX-2, Wan configs, etc.); None leaves the
model default in place.
Compat (fastvideo/api/compat.py):
- legacy_from_pretrained_to_config splits incoming
torch_compile_kwargs={backend, fullgraph, mode, dynamic, ...}
across the four typed fields and drops the remainder into extras.
- generator_config_to_fastvideo_args reconstructs the flat
torch_compile_kwargs dict via _compile_config_to_torch_kwargs,
emitting only user-set typed fields plus extras.
- legacy ltx2_vae_tiling routes to pipeline.vae_tiling on the way in
and back to ltx2_vae_tiling on the way out.
Parity inventory (docs/design/inference_schema_parity_inventory.yaml):
- torch_compile_kwargs now maps to the comma-separated leaf
generator.engine.compile.backend,fullgraph,mode,dynamic,extras
- ltx2_vae_tiling reclassified from preset_owned nested dict
(.preset_overrides.ltx2.vae_tiling) to moved (.pipeline.vae_tiling)
11 new tests in fastvideo/tests/api/test_compat_translation.py cover
typed-key promotion, extras merge, None suppression, round-trip back
to FastVideoArgs, and the vae_tiling forward/reverse path. Parser
round-trip fixture updated for the new schema fields.
SolitaryThinker