feat: add guided exploration and share user-started MCP backend

artemis/data_engine/storage.py

@@ -380,17 +380,33 @@ class StorageManager:
                 )
             conn.commit()
 
-    def discard_session_recordings(self, session_id: str) -> None:
+    def discard_session_recordings(
+        self, session_id: str, *, preserve_directory: Path | None = None
+    ) -> None:
         """Remove references to temporary analysis-only captures after the run."""
         with self._get_connection() as conn:
-            conn.execute(
-                "UPDATE video_recordings SET local_video_path = NULL, status = 'unavailable' "
-                "WHERE session_id = ?",
+            rows = conn.execute(
+                "SELECT video_id, local_video_path FROM video_recordings WHERE session_id = ?",
                 (session_id,),
-            )
+            ).fetchall()
+            retained = None
+            for row in rows:
+                path = Path(row["local_video_path"]).resolve() if row["local_video_path"] else None
+                if (
+                    preserve_directory
+                    and path
+                    and path.is_relative_to(preserve_directory.resolve())
+                    and path.is_file()
+                ):
+                    retained = str(path)
+                    continue
+                conn.execute(
+                    "UPDATE video_recordings SET local_video_path = NULL, status = 'unavailable' WHERE video_id = ?",
+                    (row["video_id"],),
+                )
             conn.execute(
-                "UPDATE sessions SET video_filepath = NULL WHERE session_id = ?",
-                (session_id,),
+                "UPDATE sessions SET video_filepath = ? WHERE session_id = ?",
+                (retained, session_id),
             )
             conn.commit()