Merge pull request #96 from SentienceAPI/overlay

overlay

Author: rcholic

sentience/agent.py

@@ -165,6 +165,8 @@ def act(  # noqa: C901
                         )
                     else:
                         snap_opts.screenshot = False
+                    # Apply show_overlay from AgentConfig
+                    snap_opts.show_overlay = self.config.show_overlay
 
                 # Call snapshot with options object (matches TypeScript API)
                 snap = snapshot(self.browser, snap_opts)
@@ -845,6 +847,9 @@ async def act(  # noqa: C901
                         )
                     else:
                         snap_opts.screenshot = False
+                    # Apply show_overlay from AgentConfig
+                    # Note: User can override by explicitly passing show_overlay in snapshot_options
+                    snap_opts.show_overlay = self.config.show_overlay
 
                 # Call snapshot with options object (matches TypeScript API)
                 snap = await snapshot_async(self.browser, snap_opts)

sentience/agent_config.py

@@ -41,3 +41,6 @@ class AgentConfig:
     capture_screenshots: bool = True
     screenshot_format: str = "jpeg"  # "png" or "jpeg"
     screenshot_quality: int = 80  # 1-100 (for JPEG only)
+
+    # Visual overlay options
+    show_overlay: bool = False  # Show green bbox overlay in browser