compare view

core/schema/models/stage.py

@@ -35,6 +35,16 @@ class StageIO:
     optional_reads: List[str] = field(default_factory=list)
 
 
+@dataclass
+class StageOutputHint:
+    """How to render a stage output in the compare/editor views."""
+    key: str          # key in the stage output JSON, e.g. "edge_regions_by_frame"
+    type: str         # "boxes_by_frame" | "overlay"
+    label: str = ""
+    default_opacity: float = 0.5
+    src_format: str = "png"  # for overlays
+
+
 @dataclass
 class StageDefinition:
     """Complete metadata for a pipeline stage."""
@@ -44,6 +54,7 @@ class StageDefinition:
     category: str = "detection"
     io: StageIO = field(default_factory=StageIO)
     config_fields: List[StageConfigField] = field(default_factory=list)
+    output_hints: List[StageOutputHint] = field(default_factory=list)
     tracks_element: Optional[str] = None
 
 
@@ -139,6 +150,7 @@ class PipelineConfig:
 STAGE_VIEWS = [
     StageConfigField,
     StageIO,
+    StageOutputHint,
     StageDefinition,
     FrameExtractionConfig,
     SceneFilterConfig,