feat(display): add reuse flag to Display protocol

- Add reuse parameter to Display.init() for all backends
- PygameDisplay: reuse existing SDL window via class-level flag
- TerminalDisplay: skip re-init when reuse=True
- WebSocketDisplay: skip server start when reuse=True
- SixelDisplay, KittyDisplay, NullDisplay: ignore reuse (not applicable)
- MultiDisplay: pass reuse to child displays
- Update benchmark.py to reuse pygame display for effect benchmarks
- Add test_websocket_e2e.py with e2e marker
- Register e2e marker in pyproject.toml

engine/display/backends/pygame.py

@@ -6,12 +6,16 @@ import time
 
 
 class PygameDisplay:
-    """Pygame display backend - renders to native window."""
+    """Pygame display backend - renders to native window.
+
+    Supports reuse mode - when reuse=True, skips SDL initialization
+    and reuses the existing pygame window from a previous instance.
+    """
 
     width: int = 80
-    height: int = 24
     window_width: int = 800
     window_height: int = 600
+    _pygame_initialized: bool = False
 
     def __init__(
         self,
@@ -76,20 +80,37 @@ class PygameDisplay:
 
         return None
 
-    def init(self, width: int, height: int) -> None:
+    def init(self, width: int, height: int, reuse: bool = False) -> None:
+        """Initialize display with dimensions.
+
+        Args:
+            width: Terminal width in characters
+            height: Terminal height in rows
+            reuse: If True, attach to existing pygame window instead of creating new
+        """
         self.width = width
         self.height = height
 
+        import os
+
+        os.environ["SDL_VIDEODRIVER"] = "x11"
+
         try:
             import pygame
         except ImportError:
             return
 
+        if reuse and PygameDisplay._pygame_initialized:
+            self._pygame = pygame
+            self._initialized = True
+            return
+
         pygame.init()
-        self._pygame = pygame
+        pygame.display.set_caption("Mainline")
 
         self._screen = pygame.display.set_mode((self.window_width, self.window_height))
-        pygame.display.set_caption("Mainline")
+        self._pygame = pygame
+        PygameDisplay._pygame_initialized = True
 
         font_path = self._get_font_path()
         if font_path:
@@ -218,6 +239,18 @@ class PygameDisplay:
             self._screen.fill((0, 0, 0))
             self._pygame.display.flip()
 
-    def cleanup(self) -> None:
-        if self._pygame:
+    def cleanup(self, quit_pygame: bool = True) -> None:
+        """Cleanup display resources.
+
+        Args:
+            quit_pygame: If True, quit pygame entirely. Set to False when
+                        reusing the display to avoid closing shared window.
+        """
+        if quit_pygame and self._pygame:
             self._pygame.quit()
+            PygameDisplay._pygame_initialized = False
+
+    @classmethod
+    def reset_state(cls) -> None:
+        """Reset pygame state - useful for testing."""
+        cls._pygame_initialized = False