a

core/detect/checkpoint/serializer.py

@@ -6,6 +6,9 @@ This file has no model-specific knowledge — stages own their data format.
 
 The only things serialized here are the "envelope" fields (job_id, video_path, etc.)
 that don't belong to any stage.
+
+Frames are ephemeral (in-memory during a run). Serialization stores
+metadata only; frames are re-extracted from chunks when needed.
 """
 
 from __future__ import annotations
@@ -18,10 +21,10 @@ from core.schema.serializers.pipeline import (
 
 
 # Envelope fields — not owned by any stage, always present
-ENVELOPE_KEYS = ["job_id", "video_path", "profile_name", "config_overrides"]
+ENVELOPE_KEYS = ["job_id", "video_path", "profile_name", "timeline_id", "config_overrides"]
 
 
-def serialize_state(state: dict, frames_manifest: dict[int, str]) -> dict:
+def serialize_state(state: dict) -> dict:
     """
     Serialize DetectState to a JSON-compatible dict.
 
@@ -37,9 +40,6 @@ def serialize_state(state: dict, frames_manifest: dict[int, str]) -> dict:
         default = {} if key == "config_overrides" else ""
         checkpoint[key] = state.get(key, default)
 
-    # Frames manifest (needed by frame-loading stages)
-    checkpoint["frames_manifest"] = {str(k): v for k, v in frames_manifest.items()}
-
     # Stats (shared across stages, not owned by one)
     stats = state.get("stats")
     if stats is not None:
@@ -60,8 +60,9 @@ def serialize_state(state: dict, frames_manifest: dict[int, str]) -> dict:
 
 def deserialize_state(checkpoint: dict, frames: list) -> dict:
     """
-    Reconstitute DetectState from a checkpoint dict + loaded frames.
+    Reconstitute DetectState from a checkpoint dict + frames.
 
+    Frames are provided by the caller (re-extracted from chunks).
     Calls each stage's deserialize_fn to restore stage-owned data.
     """
     from core.detect.stages.base import _REGISTRY
@@ -75,7 +76,7 @@ def deserialize_state(checkpoint: dict, frames: list) -> dict:
         default = {} if key == "config_overrides" else ""
         state[key] = checkpoint.get(key, default)
 
-    # Frames (always present, loaded externally)
+    # Frames (provided externally, ephemeral)
     state["frames"] = frames
 
     # Stats