Add grid planner, CI, and tests

server/grid.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from typing import Dict, Tuple
+from typing import Dict, List, Tuple, Any
 import uuid
 
 from .actions import ActionEngine
@@ -31,6 +31,7 @@ class VisionGrid:
         self.width = request.width
         self.height = request.height
         self.cells: Dict[str, _StoredCell] = {}
+        self._action_history: List[dict[str, Any]] = []
         self._engine = ActionEngine(self)
         self._build_cells()
 
@@ -75,7 +76,22 @@ class VisionGrid:
         return cell.center
 
     def apply_action(self, payload: ActionPayload) -> ActionResult:
-        return self._engine.plan(payload)
+        result = self._engine.plan(payload)
+        self._action_history.append(result.model_dump())
+        return result
+
+    @property
+    def action_history(self) -> List[dict[str, Any]]:
+        return list(self._action_history)
+
+    def summary(self) -> str:
+        last_action = self._action_history[-1] if self._action_history else None
+        last_summary = (
+            f"Last action: {last_action.get('detail')}" if last_action else "No actions recorded yet"
+        )
+        return (
+            f"Grid {self.grid_id} ({self.rows}x{self.columns}) with {len(self.cells)} cells. {last_summary}."
+        )
 
 
 class GridManager:
@@ -100,3 +116,9 @@ class GridManager:
             return self._grids[grid_id]
         except KeyError as exc:
             raise KeyError(f"Grid {grid_id} not found") from exc
+
+    def get_history(self, grid_id: str) -> List[dict[str, Any]]:
+        return self.get_grid(grid_id).action_history
+
+    def clear(self) -> None:
+        self._grids.clear()