Release v4.5.13

Author: MervinPraison

docker/Dockerfile.chat

@@ -16,7 +16,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=4.5.12" \
+    "praisonai>=4.5.13" \
     "praisonai[chat]" \
     "embedchain[github,youtube]"
 

docker/Dockerfile.dev

@@ -20,7 +20,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=4.5.12" \
+    "praisonai>=4.5.13" \
     "praisonai[ui]" \
     "praisonai[chat]" \
     "praisonai[realtime]" \

docker/Dockerfile.ui

@@ -16,7 +16,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=4.5.12" \
+    "praisonai>=4.5.13" \
     "praisonai[ui]" \
     "praisonai[crewai]"
 

src/praisonai-agents/praisonaiagents/agent/agent.py

@@ -1918,6 +1918,9 @@ def _init_autonomy(self, autonomy: Any, verification_hooks: Optional[List[Any]]
             self.autonomy_config = {}
             self._autonomy_trigger = None
             self._doom_loop_tracker = None
+            self._file_snapshot = None
+            self._snapshot_stack = []
+            self._redo_stack = []
             return
 
         self.autonomy_enabled = True
@@ -1942,6 +1945,9 @@ def _init_autonomy(self, autonomy: Any, verification_hooks: Optional[List[Any]]
             self.autonomy_config = {}
             self._autonomy_trigger = None
             self._doom_loop_tracker = None
+            self._file_snapshot = None
+            self._snapshot_stack = []
+            self._redo_stack = []
             return
 
         # Preserve ALL AutonomyConfig fields in the dict (G14 fix: no lossy extraction)
@@ -1954,6 +1960,8 @@ def _init_autonomy(self, autonomy: Any, verification_hooks: Optional[List[Any]]
             "observe": config.observe,
             "completion_promise": config.completion_promise,
             "clear_context": config.clear_context,
+            "track_changes": config.effective_track_changes,
+            "snapshot_dir": config.snapshot_dir,
         }
         # Also preserve any extra user-provided keys from dict input
         if isinstance(autonomy, dict):
@@ -1967,6 +1975,21 @@ def _init_autonomy(self, autonomy: Any, verification_hooks: Optional[List[Any]]
         self._autonomy_trigger = AutonomyTrigger()
         self._doom_loop_tracker = DoomLoopTracker(threshold=config.doom_loop_threshold)
 
+        # Initialize FileSnapshot for filesystem tracking (lazy import)
+        self._file_snapshot = None
+        self._snapshot_stack = []  # Stack of snapshot hashes for undo/redo
+        self._redo_stack = []  # Redo stack
+        if config.effective_track_changes:
+            try:
+                from ..snapshot import FileSnapshot
+                import os
+                self._file_snapshot = FileSnapshot(
+                    project_path=os.getcwd(),
+                    snapshot_dir=config.snapshot_dir,
+                )
+            except Exception as e:
+                logger.debug(f"FileSnapshot init failed (git may not be available): {e}")
+        
         # Wire ObservabilityHooks when observe=True (G-UNUSED-2 fix)
         if config.observe:
             from ..escalation.observability import ObservabilityHooks
@@ -1977,6 +2000,93 @@ def _init_autonomy(self, autonomy: Any, verification_hooks: Optional[List[Any]]
         # Wire level → approval bridge (G3 fix)
         self._bridge_autonomy_level(config.level)
 
+    # ================================================================
+    # Filesystem tracking convenience methods (powered by FileSnapshot)
+    # ================================================================
+    
+    def undo(self) -> bool:
+        """Undo the last set of file changes.
+        
+        Restores files to the state before the last autonomous iteration.
+        Requires ``autonomy=AutonomyConfig(track_changes=True)``.
+        
+        Returns:
+            True if undo was successful, False if nothing to undo.
+            
+        Example::
+        
+            agent = Agent(autonomy="full_auto")
+            result = agent.start("Refactor utils.py")
+            agent.undo()  # Restore original files
+        """
+        if self._file_snapshot is None or not self._snapshot_stack:
+            return False
+        try:
+            target_hash = self._snapshot_stack.pop()
+            # Get current hash before restore (for redo)
+            current_hash = self._file_snapshot.get_current_hash()
+            if current_hash:
+                self._redo_stack.append(current_hash)
+            self._file_snapshot.restore(target_hash)
+            return True
+        except Exception as e:
+            logger.debug(f"Undo failed: {e}")
+            return False
+    
+    def redo(self) -> bool:
+        """Redo a previously undone set of file changes.
+        
+        Re-applies file changes that were reverted by :meth:`undo`.
+        
+        Returns:
+            True if redo was successful, False if nothing to redo.
+        """
+        if self._file_snapshot is None or not self._redo_stack:
+            return False
+        try:
+            target_hash = self._redo_stack.pop()
+            current_hash = self._file_snapshot.get_current_hash()
+            if current_hash:
+                self._snapshot_stack.append(current_hash)
+            self._file_snapshot.restore(target_hash)
+            return True
+        except Exception as e:
+            logger.debug(f"Redo failed: {e}")
+            return False
+    
+    def diff(self, from_hash: Optional[str] = None):
+        """Get file diffs from autonomous execution.
+        
+        Returns a list of :class:`FileDiff` objects showing what files
+        were modified, with additions/deletions counts.
+        
+        Args:
+            from_hash: Base commit hash to diff from. If None, uses the
+                first snapshot (pre-autonomous state).
+        
+        Returns:
+            List of FileDiff objects, or empty list if tracking not enabled.
+            
+        Example::
+        
+            agent = Agent(autonomy="full_auto")
+            result = agent.start("Refactor utils.py")
+            for d in agent.diff():
+                print(f"{d.status}: {d.path} (+{d.additions}/-{d.deletions})")
+        """
+        if self._file_snapshot is None:
+            return []
+        try:
+            base = from_hash
+            if base is None and self._snapshot_stack:
+                base = self._snapshot_stack[0]
+            if base is None:
+                return []
+            return self._file_snapshot.diff(base)
+        except Exception as e:
+            logger.debug(f"Diff failed: {e}")
+            return []
+    
     def analyze_prompt(self, prompt: str) -> set:
         """Analyze prompt for autonomy signals.
         
@@ -2159,6 +2269,15 @@ def run_autonomous(
                 "Create agent with autonomy=True or autonomy={...}"
             )
 
+        # Take initial snapshot before autonomous execution starts
+        if self._file_snapshot is not None:
+            try:
+                snap_info = self._file_snapshot.track(message="pre-autonomous")
+                self._snapshot_stack.append(snap_info.commit_hash)
+                self._redo_stack.clear()
+            except Exception as e:
+                logger.debug(f"Pre-autonomous snapshot failed: {e}")
+        
         start_time = time_module.time()
         started_at = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z")
         iterations = 0

src/praisonai-agents/praisonaiagents/agent/autonomy.py

@@ -77,6 +77,9 @@
 class AutonomyConfig:
     """Configuration for Agent autonomy features.
     
+    Autonomy is the safety center: doom loops, escalation, sandbox,
+    filesystem tracking, and verification hooks all live here.
+    
     Attributes:
         enabled: Whether autonomy is enabled
         level: Autonomy level (suggest, auto_edit, full_auto)
@@ -87,6 +90,24 @@ class AutonomyConfig:
         completion_promise: Optional string that signals completion when wrapped in <promise>TEXT</promise>
         clear_context: Whether to clear chat history between iterations
         verification_hooks: List of VerificationHook instances for output verification
+        track_changes: Whether to track filesystem changes via shadow git.
+            Defaults to True when level="full_auto", False otherwise.
+            When enabled, agent.undo()/redo()/diff() become available.
+        sandbox: Optional SandboxConfig for execution isolation.
+            When level="full_auto" and sandbox is None, subprocess sandbox is auto-enabled.
+        snapshot_dir: Directory for snapshot storage. Defaults to ~/.praisonai/snapshots.
+    
+    Usage::
+    
+        # Simple — full_auto auto-enables tracking + sandbox
+        Agent(autonomy="full_auto")
+        
+        # Advanced — explicit config
+        Agent(autonomy=AutonomyConfig(
+            level="full_auto",
+            track_changes=True,
+            sandbox=SandboxConfig.native(writable_paths=["./src"]),
+        ))
     """
     enabled: bool = True
     level: str = "suggest"
@@ -97,13 +118,31 @@ class AutonomyConfig:
     completion_promise: Optional[str] = None
     clear_context: bool = False
     verification_hooks: Optional[List[Any]] = None
+    # Safety features — autonomy owns the safety model
+    track_changes: Optional[bool] = None  # None = auto (True for full_auto)
+    sandbox: Optional[Any] = None  # SandboxConfig (lazy import to avoid circular)
+    snapshot_dir: Optional[str] = None  # Defaults to ~/.praisonai/snapshots
 
     def __post_init__(self):
         if self.level not in VALID_AUTONOMY_LEVELS:
             raise ValueError(
                 f"Invalid autonomy level: {self.level!r}. "
                 f"Must be one of {sorted(VALID_AUTONOMY_LEVELS)}"
             )
+        # Auto-enable track_changes for full_auto if not explicitly set
+        if self.track_changes is None:
+            self.track_changes = (self.level == "full_auto")
+        # Default snapshot directory
+        if self.snapshot_dir is None:
+            import os
+            self.snapshot_dir = os.path.join(
+                os.path.expanduser("~"), ".praisonai", "snapshots"
+            )
+    
+    @property
+    def effective_track_changes(self) -> bool:
+        """Whether track_changes is effectively enabled."""
+        return bool(self.track_changes)
 
     @classmethod
     def from_dict(cls, data: Dict[str, Any]) -> "AutonomyConfig":
@@ -124,6 +163,9 @@ def from_dict(cls, data: Dict[str, Any]) -> "AutonomyConfig":
             completion_promise=data.get("completion_promise"),
             clear_context=data.get("clear_context", False),
             verification_hooks=data.get("verification_hooks"),
+            track_changes=data.get("track_changes"),
+            sandbox=data.get("sandbox"),
+            snapshot_dir=data.get("snapshot_dir"),
         )