[Core] Remove legacy stage config exports

docs/api/README.md

@@ -126,7 +126,7 @@ Core scheduling and caching components.
 Configuration classes.
 
 - [vllm_omni.config.model.OmniModelConfig][]
-- [vllm_omni.config.stage_config.StageConfig][]
+- [vllm_omni.config.omni_config.VllmOmniConfig][]
 - [vllm_omni.config.stage_config.StageConfigFactory][]
 - [vllm_omni.config.stage_config.StageType][]
 - [vllm_omni.diffusion.cache.teacache.config.TeaCacheConfig][]

tests/config/test_config_import_cycle.py

@@ -58,6 +58,16 @@ def test_config_package_lazy_exports_still_resolve() -> None:
     assert register_pipeline is direct_register_pipeline
 
 
+def test_config_package_does_not_export_legacy_stage_bridge() -> None:
+    """The public config API exposes structured configs, not legacy adapters."""
+    import vllm_omni.config as config
+
+    assert "StageConfig" not in config.__all__
+    assert "merge_pipeline_deploy" not in config.__all__
+    assert not hasattr(config, "StageConfig")
+    assert not hasattr(config, "merge_pipeline_deploy")
+
+
 def test_npu_platform_defers_minimax_h3_encoder_patch() -> None:
     src = (REPO_ROOT / "vllm_omni" / "platforms" / "npu" / "platform.py").read_text(encoding="utf-8")
     init_start = src.index("def __init__(self) -> None:")

vllm_omni/config/__init__.py

@@ -25,13 +25,11 @@
     PIPELINE_WIDE_ENGINE_FIELDS,
     DeployConfig,
     PipelineConfig,
-    StageConfig,
     StageDeployConfig,
     StageExecutionType,
     StagePipelineConfig,
     StageType,
     load_deploy_config,
-    merge_pipeline_deploy,
 )
 from vllm_omni.config.yaml_util import (
     create_config,
@@ -78,14 +76,12 @@
     "PIPELINE_WIDE_ENGINE_FIELDS",
     "DeployConfig",
     "PipelineConfig",
-    "StageConfig",
     "StageConfigFactory",
     "StageDeployConfig",
     "StageType",
     "StageExecutionType",
     "StagePipelineConfig",
     "load_deploy_config",
-    "merge_pipeline_deploy",
     "register_pipeline",
     # YAML utility helpers.
     "create_config",