praisonAI 2.3.87__tar.gz → 2.4.0__tar.gz

{praisonai-2.3.87 → praisonai-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 2.3.87
+Version: 2.4.0
 Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
 Author: Mervin Praison
 License: MIT
@@ -11,7 +11,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: rich>=13.7
 Requires-Dist: markdown>=3.5
 Requires-Dist: pyparsing>=3.0.0
-Requires-Dist: praisonaiagents>=0.1.27
+Requires-Dist: praisonaiagents>=0.2.0
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: instructor>=1.3.3
 Requires-Dist: PyYAML>=6.0
@@ -960,21 +960,75 @@ callbacks:
 
 ### 9. Hooks
 
-Configure in `.praison/hooks.json`:
+Intercept and modify agent behavior at various lifecycle points:
 
 ```python
-from praisonaiagents.memory import HooksManager
+from praisonaiagents.hooks import (
+    HookRegistry, HookRunner, HookEvent, HookResult,
+    BeforeToolInput
+)
+
+# Create a hook registry
+registry = HookRegistry()
 
-hooks = HooksManager()
+# Log all tool calls
+@registry.on(HookEvent.BEFORE_TOOL)
+def log_tools(event_data: BeforeToolInput) -> HookResult:
+    print(f"Tool: {event_data.tool_name}")
+    return HookResult.allow()
 
-# Register Python hooks
-hooks.register("pre_write_code", lambda ctx: print(f"Writing {ctx['file']}"))
+# Block dangerous operations
+@registry.on(HookEvent.BEFORE_TOOL)
+def security_check(event_data: BeforeToolInput) -> HookResult:
+    if "delete" in event_data.tool_name.lower():
+        return HookResult.deny("Delete operations blocked")
+    return HookResult.allow()
 
 # Execute hooks
-result = hooks.execute("pre_write_code", {"file": "main.py"})
+runner = HookRunner(registry)
+```
+
+**CLI Commands:**
+```bash
+praisonai hooks list                    # List registered hooks
+praisonai hooks test before_tool        # Test hooks for an event
+praisonai hooks run "echo test"         # Run a command hook
+praisonai hooks validate hooks.json     # Validate configuration
+```
+
+
+### 10. Shadow Git Checkpoints
+
+File-level undo/restore using shadow git:
+
+```python
+from praisonaiagents.checkpoints import CheckpointService
+
+service = CheckpointService(workspace_dir="./my_project")
+await service.initialize()
+
+# Save checkpoint before changes
+result = await service.save("Before refactoring")
+
+# Make changes...
+
+# Restore if needed
+await service.restore(result.checkpoint.id)
+
+# View diff
+diff = await service.diff()
 ```
 
-### 10. Field Names Reference (A-I-G-S)
+**CLI Commands:**
+```bash
+praisonai checkpoint save "Before changes"  # Save checkpoint
+praisonai checkpoint list                   # List checkpoints
+praisonai checkpoint diff                   # Show changes
+praisonai checkpoint restore abc123         # Restore to checkpoint
+```
+
+
+### 11. Field Names Reference (A-I-G-S)
 
 PraisonAI accepts both old (agents.yaml) and new (workflow.yaml) field names. Use the **canonical names** for new projects:
 
@@ -1008,7 +1062,7 @@ steps:                         # Define steps (not 'tasks')
 
 > **Note:** The parser accepts both old and new names. Run `praisonai workflow validate <file.yaml>` to see suggestions for canonical names.
 
-### 11. Extended agents.yaml with Workflow Patterns
+### 12. Extended agents.yaml with Workflow Patterns
 
 **Feature Parity:** Both `agents.yaml` and `workflow.yaml` now support the same features:
 - All workflow patterns (route, parallel, loop, repeat)

{praisonai-2.3.87 → praisonai-2.4.0}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 2.3.87
+Version: 2.4.0
 Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
 Author: Mervin Praison
 License: MIT
@@ -11,7 +11,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: rich>=13.7
 Requires-Dist: markdown>=3.5
 Requires-Dist: pyparsing>=3.0.0
-Requires-Dist: praisonaiagents>=0.1.27
+Requires-Dist: praisonaiagents>=0.2.0
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: instructor>=1.3.3
 Requires-Dist: PyYAML>=6.0
@@ -960,21 +960,75 @@ callbacks:
 
 ### 9. Hooks
 
-Configure in `.praison/hooks.json`:
+Intercept and modify agent behavior at various lifecycle points:
 
 ```python
-from praisonaiagents.memory import HooksManager
+from praisonaiagents.hooks import (
+    HookRegistry, HookRunner, HookEvent, HookResult,
+    BeforeToolInput
+)
+
+# Create a hook registry
+registry = HookRegistry()
 
-hooks = HooksManager()
+# Log all tool calls
+@registry.on(HookEvent.BEFORE_TOOL)
+def log_tools(event_data: BeforeToolInput) -> HookResult:
+    print(f"Tool: {event_data.tool_name}")
+    return HookResult.allow()
 
-# Register Python hooks
-hooks.register("pre_write_code", lambda ctx: print(f"Writing {ctx['file']}"))
+# Block dangerous operations
+@registry.on(HookEvent.BEFORE_TOOL)
+def security_check(event_data: BeforeToolInput) -> HookResult:
+    if "delete" in event_data.tool_name.lower():
+        return HookResult.deny("Delete operations blocked")
+    return HookResult.allow()
 
 # Execute hooks
-result = hooks.execute("pre_write_code", {"file": "main.py"})
+runner = HookRunner(registry)
+```
+
+**CLI Commands:**
+```bash
+praisonai hooks list                    # List registered hooks
+praisonai hooks test before_tool        # Test hooks for an event
+praisonai hooks run "echo test"         # Run a command hook
+praisonai hooks validate hooks.json     # Validate configuration
+```
+
+
+### 10. Shadow Git Checkpoints
+
+File-level undo/restore using shadow git:
+
+```python
+from praisonaiagents.checkpoints import CheckpointService
+
+service = CheckpointService(workspace_dir="./my_project")
+await service.initialize()
+
+# Save checkpoint before changes
+result = await service.save("Before refactoring")
+
+# Make changes...
+
+# Restore if needed
+await service.restore(result.checkpoint.id)
+
+# View diff
+diff = await service.diff()
 ```
 
-### 10. Field Names Reference (A-I-G-S)
+**CLI Commands:**
+```bash
+praisonai checkpoint save "Before changes"  # Save checkpoint
+praisonai checkpoint list                   # List checkpoints
+praisonai checkpoint diff                   # Show changes
+praisonai checkpoint restore abc123         # Restore to checkpoint
+```
+
+
+### 11. Field Names Reference (A-I-G-S)
 
 PraisonAI accepts both old (agents.yaml) and new (workflow.yaml) field names. Use the **canonical names** for new projects:
 
@@ -1008,7 +1062,7 @@ steps:                         # Define steps (not 'tasks')
 
 > **Note:** The parser accepts both old and new names. Run `praisonai workflow validate <file.yaml>` to see suggestions for canonical names.
 
-### 11. Extended agents.yaml with Workflow Patterns
+### 12. Extended agents.yaml with Workflow Patterns
 
 **Feature Parity:** Both `agents.yaml` and `workflow.yaml` now support the same features:
 - All workflow patterns (route, parallel, loop, repeat)

{praisonai-2.3.87 → praisonai-2.4.0}/PraisonAI.egg-info/SOURCES.txt

@@ -31,7 +31,9 @@ praisonai/cli/features/agents.py
 praisonai/cli/features/at_mentions.py
 praisonai/cli/features/auto_memory.py
 praisonai/cli/features/autonomy_mode.py
+praisonai/cli/features/background.py
 praisonai/cli/features/base.py
+praisonai/cli/features/checkpoints.py
 praisonai/cli/features/compare.py
 praisonai/cli/features/cost_tracker.py
 praisonai/cli/features/eval.py
@@ -41,6 +43,7 @@ praisonai/cli/features/flow_display.py
 praisonai/cli/features/git_integration.py
 praisonai/cli/features/guardrail.py
 praisonai/cli/features/handoff.py
+praisonai/cli/features/hooks.py
 praisonai/cli/features/image.py
 praisonai/cli/features/interactive_tui.py
 praisonai/cli/features/knowledge.py

{praisonai-2.3.87 → praisonai-2.4.0}/PraisonAI.egg-info/requires.txt

@@ -1,7 +1,7 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=0.1.27
+praisonaiagents>=0.2.0
 python-dotenv>=0.19.0
 instructor>=1.3.3
 PyYAML>=6.0

{praisonai-2.3.87 → praisonai-2.4.0}/README.md

@@ -863,21 +863,75 @@ callbacks:
 
 ### 9. Hooks
 
-Configure in `.praison/hooks.json`:
+Intercept and modify agent behavior at various lifecycle points:
 
 ```python
-from praisonaiagents.memory import HooksManager
+from praisonaiagents.hooks import (
+    HookRegistry, HookRunner, HookEvent, HookResult,
+    BeforeToolInput
+)
+
+# Create a hook registry
+registry = HookRegistry()
 
-hooks = HooksManager()
+# Log all tool calls
+@registry.on(HookEvent.BEFORE_TOOL)
+def log_tools(event_data: BeforeToolInput) -> HookResult:
+    print(f"Tool: {event_data.tool_name}")
+    return HookResult.allow()
 
-# Register Python hooks
-hooks.register("pre_write_code", lambda ctx: print(f"Writing {ctx['file']}"))
+# Block dangerous operations
+@registry.on(HookEvent.BEFORE_TOOL)
+def security_check(event_data: BeforeToolInput) -> HookResult:
+    if "delete" in event_data.tool_name.lower():
+        return HookResult.deny("Delete operations blocked")
+    return HookResult.allow()
 
 # Execute hooks
-result = hooks.execute("pre_write_code", {"file": "main.py"})
+runner = HookRunner(registry)
+```
+
+**CLI Commands:**
+```bash
+praisonai hooks list                    # List registered hooks
+praisonai hooks test before_tool        # Test hooks for an event
+praisonai hooks run "echo test"         # Run a command hook
+praisonai hooks validate hooks.json     # Validate configuration
+```
+
+
+### 10. Shadow Git Checkpoints
+
+File-level undo/restore using shadow git:
+
+```python
+from praisonaiagents.checkpoints import CheckpointService
+
+service = CheckpointService(workspace_dir="./my_project")
+await service.initialize()
+
+# Save checkpoint before changes
+result = await service.save("Before refactoring")
+
+# Make changes...
+
+# Restore if needed
+await service.restore(result.checkpoint.id)
+
+# View diff
+diff = await service.diff()
 ```
 
-### 10. Field Names Reference (A-I-G-S)
+**CLI Commands:**
+```bash
+praisonai checkpoint save "Before changes"  # Save checkpoint
+praisonai checkpoint list                   # List checkpoints
+praisonai checkpoint diff                   # Show changes
+praisonai checkpoint restore abc123         # Restore to checkpoint
+```
+
+
+### 11. Field Names Reference (A-I-G-S)
 
 PraisonAI accepts both old (agents.yaml) and new (workflow.yaml) field names. Use the **canonical names** for new projects:
 
@@ -911,7 +965,7 @@ steps:                         # Define steps (not 'tasks')
 
 > **Note:** The parser accepts both old and new names. Run `praisonai workflow validate <file.yaml>` to see suggestions for canonical names.
 
-### 11. Extended agents.yaml with Workflow Patterns
+### 12. Extended agents.yaml with Workflow Patterns
 
 **Feature Parity:** Both `agents.yaml` and `workflow.yaml` now support the same features:
 - All workflow patterns (route, parallel, loop, repeat)

{praisonai-2.3.87 → praisonai-2.4.0}/praisonai/cli/features/__init__.py

@@ -29,6 +29,9 @@ Features:
 - at_mentions: @ mention autocomplete for files and directories
 - compare: CLI command comparison feature
 - eval: Agent evaluation framework (accuracy, performance, reliability, criteria)
+- hooks: Hook system for intercepting and modifying agent behavior
+- checkpoints: Shadow git checkpointing for file-level undo/restore
+- background: Background agent task execution and management
 """
 
 # Type hints available for IDE support
@@ -71,6 +74,12 @@ __all__ = [
     'CompareHandler',
     # Agent Skills
     'SkillsHandler',
+    # Hooks
+    'HooksHandler',
+    # Checkpoints
+    'CheckpointsHandler',
+    # Background
+    'BackgroundHandler',
 ]
 
 def __getattr__(name):
@@ -170,4 +179,13 @@ def __getattr__(name):
     elif name == 'SkillsHandler':
         from .skills import SkillsHandler
         return SkillsHandler
+    elif name == 'HooksHandler':
+        from .hooks import HooksHandler
+        return HooksHandler
+    elif name == 'CheckpointsHandler':
+        from .checkpoints import CheckpointsHandler
+        return CheckpointsHandler
+    elif name == 'BackgroundHandler':
+        from .background import BackgroundHandler
+        return BackgroundHandler
     raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

praisonai-2.4.0/praisonai/cli/features/background.py

@@ -0,0 +1,296 @@
+"""
+Background Agents CLI Feature for PraisonAI.
+
+Provides CLI commands for managing background agent tasks.
+
+Commands:
+- praisonai background list              # List background tasks
+- praisonai background status <id>       # Get task status
+- praisonai background cancel <id>       # Cancel a task
+- praisonai background clear             # Clear completed tasks
+"""
+
+import os
+import asyncio
+from typing import Optional, List
+
+
+class BackgroundHandler:
+    """
+    Handler for background CLI commands.
+    
+    Provides functionality to:
+    - List running and completed background tasks
+    - Check task status
+    - Cancel running tasks
+    - Clear completed tasks
+    """
+    
+    def __init__(self, verbose: bool = False):
+        self.verbose = verbose
+        self._runner = None
+    
+    @property
+    def feature_name(self) -> str:
+        return "background"
+    
+    async def _get_runner(self):
+        """Lazy load the background runner."""
+        if self._runner is None:
+            from praisonaiagents.background import BackgroundRunner
+            self._runner = BackgroundRunner()
+        return self._runner
+    
+    async def list_tasks(self, status: Optional[str] = None) -> List[dict]:
+        """
+        List all background tasks.
+        
+        Args:
+            status: Optional status filter (pending, running, completed, failed)
+            
+        Returns:
+            List of task dictionaries
+        """
+        runner = await self._get_runner()
+        
+        status_enum = None
+        if status:
+            from praisonaiagents.background import TaskStatus
+            status_map = {
+                "pending": TaskStatus.PENDING,
+                "running": TaskStatus.RUNNING,
+                "completed": TaskStatus.COMPLETED,
+                "failed": TaskStatus.FAILED,
+                "cancelled": TaskStatus.CANCELLED
+            }
+            status_enum = status_map.get(status.lower())
+        
+        tasks = runner.list_tasks(status=status_enum)
+        
+        self._print_tasks_table(tasks)
+        return tasks
+    
+    def _print_tasks_table(self, tasks: List[dict]):
+        """Print tasks in table format."""
+        try:
+            from rich.console import Console
+            from rich.table import Table
+            
+            console = Console()
+            
+            if not tasks:
+                console.print("[yellow]No background tasks[/yellow]")
+                return
+            
+            table = Table(title="Background Tasks")
+            table.add_column("ID", style="cyan")
+            table.add_column("Name", style="green")
+            table.add_column("Status", style="yellow")
+            table.add_column("Progress", style="blue")
+            table.add_column("Duration", style="magenta")
+            
+            for task in tasks:
+                status = task.get("status", "unknown")
+                status_color = {
+                    "pending": "dim",
+                    "running": "yellow",
+                    "completed": "green",
+                    "failed": "red",
+                    "cancelled": "dim"
+                }.get(status, "white")
+                
+                progress = f"{task.get('progress', 0) * 100:.0f}%"
+                duration = task.get("duration_seconds")
+                duration_str = f"{duration:.1f}s" if duration else "-"
+                
+                table.add_row(
+                    task.get("id", "?"),
+                    task.get("name", "unnamed"),
+                    f"[{status_color}]{status}[/{status_color}]",
+                    progress,
+                    duration_str
+                )
+            
+            console.print(table)
+        except ImportError:
+            print("Background Tasks:")
+            for task in tasks:
+                print(f"  {task.get('id')} - {task.get('name')} ({task.get('status')})")
+    
+    async def get_status(self, task_id: str) -> Optional[dict]:
+        """
+        Get status of a specific task.
+        
+        Args:
+            task_id: Task ID
+            
+        Returns:
+            Task dictionary or None
+        """
+        runner = await self._get_runner()
+        task = runner.get_task(task_id)
+        
+        if task is None:
+            self._print_error(f"Task not found: {task_id}")
+            return None
+        
+        task_dict = task.to_dict()
+        self._print_task_details(task_dict)
+        return task_dict
+    
+    def _print_task_details(self, task: dict):
+        """Print detailed task information."""
+        try:
+            from rich.console import Console
+            from rich.panel import Panel
+            
+            console = Console()
+            
+            status = task.get("status", "unknown")
+            status_color = {
+                "pending": "dim",
+                "running": "yellow",
+                "completed": "green",
+                "failed": "red",
+                "cancelled": "dim"
+            }.get(status, "white")
+            
+            content = f"""
+[bold]ID:[/bold] {task.get('id')}
+[bold]Name:[/bold] {task.get('name')}
+[bold]Status:[/bold] [{status_color}]{status}[/{status_color}]
+[bold]Progress:[/bold] {task.get('progress', 0) * 100:.0f}%
+[bold]Created:[/bold] {task.get('created_at')}
+[bold]Started:[/bold] {task.get('started_at') or '-'}
+[bold]Completed:[/bold] {task.get('completed_at') or '-'}
+[bold]Duration:[/bold] {task.get('duration_seconds', 0):.2f}s
+"""
+            if task.get("error"):
+                content += f"[bold]Error:[/bold] [red]{task.get('error')}[/red]\n"
+            
+            if task.get("result"):
+                result_str = str(task.get("result"))[:200]
+                content += f"[bold]Result:[/bold] {result_str}\n"
+            
+            console.print(Panel(content.strip(), title=f"Task: {task.get('name')}"))
+        except ImportError:
+            print(f"Task: {task.get('name')}")
+            print(f"  ID: {task.get('id')}")
+            print(f"  Status: {task.get('status')}")
+            print(f"  Progress: {task.get('progress', 0) * 100:.0f}%")
+    
+    async def cancel_task(self, task_id: str) -> bool:
+        """
+        Cancel a running task.
+        
+        Args:
+            task_id: Task ID to cancel
+            
+        Returns:
+            True if cancelled
+        """
+        runner = await self._get_runner()
+        result = await runner.cancel_task(task_id)
+        
+        if result:
+            self._print_success(f"Task cancelled: {task_id}")
+        else:
+            self._print_error(f"Could not cancel task: {task_id}")
+        
+        return result
+    
+    async def clear_completed(self) -> int:
+        """
+        Clear all completed tasks.
+        
+        Returns:
+            Number of tasks cleared
+        """
+        runner = await self._get_runner()
+        count = len([t for t in runner.tasks if t.is_completed])
+        runner.clear_completed()
+        
+        self._print_success(f"Cleared {count} completed tasks")
+        return count
+    
+    def _print_success(self, message: str):
+        """Print success message."""
+        try:
+            from rich.console import Console
+            Console().print(f"[green]✓[/green] {message}")
+        except ImportError:
+            print(f"✓ {message}")
+    
+    def _print_error(self, message: str):
+        """Print error message."""
+        try:
+            from rich.console import Console
+            Console().print(f"[red]✗[/red] {message}")
+        except ImportError:
+            print(f"✗ {message}")
+
+
+def handle_background_command(args: List[str], verbose: bool = False):
+    """
+    Handle background CLI commands.
+    
+    Usage:
+        praisonai background list [--status <status>]
+        praisonai background status <task_id>
+        praisonai background cancel <task_id>
+        praisonai background clear
+    """
+    handler = BackgroundHandler(verbose=verbose)
+    
+    if not args:
+        print("Usage: praisonai background <command> [options]")
+        print("\nCommands:")
+        print("  list [--status <status>]  List background tasks")
+        print("  status <task_id>          Get task status")
+        print("  cancel <task_id>          Cancel a task")
+        print("  clear                     Clear completed tasks")
+        return
+    
+    command = args[0]
+    
+    if command == "list":
+        status = None
+        if "--status" in args:
+            idx = args.index("--status")
+            if idx + 1 < len(args):
+                status = args[idx + 1]
+        
+        asyncio.run(handler.list_tasks(status=status))
+    
+    elif command == "status":
+        if len(args) < 2:
+            print("Usage: praisonai background status <task_id>")
+            return
+        
+        asyncio.run(handler.get_status(args[1]))
+    
+    elif command == "cancel":
+        if len(args) < 2:
+            print("Usage: praisonai background cancel <task_id>")
+            return
+        
+        asyncio.run(handler.cancel_task(args[1]))
+    
+    elif command == "clear":
+        asyncio.run(handler.clear_completed())
+    
+    elif command == "help" or command == "--help":
+        print("Background CLI Commands:")
+        print("\n  praisonai background list [--status <status>]")
+        print("    List all background tasks")
+        print("    Status: pending, running, completed, failed, cancelled")
+        print("\n  praisonai background status <task_id>")
+        print("    Get detailed status of a specific task")
+        print("\n  praisonai background cancel <task_id>")
+        print("    Cancel a running task")
+        print("\n  praisonai background clear")
+        print("    Clear all completed tasks from the list")
+    
+    else:
+        print(f"Unknown command: {command}")
+        print("Use 'praisonai background help' for available commands")