praisonAI 3.2.0__tar.gz → 3.3.0__tar.gz

{praisonai-3.2.0 → praisonai-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 3.2.0
+Version: 3.3.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.7.0
+Requires-Dist: praisonaiagents>=0.8.0
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: instructor>=1.3.3
 Requires-Dist: PyYAML>=6.0
@@ -2037,11 +2037,11 @@ agent = Agent(
     auto_save="my-project"
 )
 
-# Load history from last 5 sessions
+# Load history from past sessions via context management
 agent = Agent(
     name="Assistant",
     memory=True,
-    history_in_context=5
+    context=True,  # Enable context management for history
 )
 ```
 

{praisonai-3.2.0 → praisonai-3.3.0}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 3.2.0
+Version: 3.3.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.7.0
+Requires-Dist: praisonaiagents>=0.8.0
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: instructor>=1.3.3
 Requires-Dist: PyYAML>=6.0
@@ -2037,11 +2037,11 @@ agent = Agent(
     auto_save="my-project"
 )
 
-# Load history from last 5 sessions
+# Load history from past sessions via context management
 agent = Agent(
     name="Assistant",
     memory=True,
-    history_in_context=5
+    context=True,  # Enable context management for history
 )
 ```
 

{praisonai-3.2.0 → praisonai-3.3.0}/PraisonAI.egg-info/SOURCES.txt

@@ -98,6 +98,7 @@ praisonai/cli/commands/realtime.py
 praisonai/cli/commands/recipe.py
 praisonai/cli/commands/registry.py
 praisonai/cli/commands/research.py
+praisonai/cli/commands/retrieval.py
 praisonai/cli/commands/rules.py
 praisonai/cli/commands/run.py
 praisonai/cli/commands/schedule.py
@@ -162,6 +163,7 @@ praisonai/cli/features/interactive_tools.py
 praisonai/cli/features/interactive_tui.py
 praisonai/cli/features/jobs.py
 praisonai/cli/features/knowledge.py
+praisonai/cli/features/knowledge_cli.py
 praisonai/cli/features/lite.py
 praisonai/cli/features/logs.py
 praisonai/cli/features/lsp_cli.py

{praisonai-3.2.0 → praisonai-3.3.0}/PraisonAI.egg-info/requires.txt

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

{praisonai-3.2.0 → praisonai-3.3.0}/README.md

@@ -1930,11 +1930,11 @@ agent = Agent(
     auto_save="my-project"
 )
 
-# Load history from last 5 sessions
+# Load history from past sessions via context management
 agent = Agent(
     name="Assistant",
     memory=True,
-    history_in_context=5
+    context=True,  # Enable context management for history
 )
 ```
 

{praisonai-3.2.0 → praisonai-3.3.0}/praisonai/cli/app.py

@@ -191,6 +191,7 @@ def register_commands():
     from .commands.tools import app as tools_app
     from .commands.knowledge import app as knowledge_app
     from .commands.rag import app as rag_app
+    from .commands import retrieval as retrieval_module
     from .commands.deploy import app as deploy_app
     from .commands.agents import app as agents_app
     from .commands.skills import app as skills_app
@@ -241,8 +242,11 @@ def register_commands():
     app.add_typer(memory_app, name="memory", help="Memory management")
     app.add_typer(workflow_app, name="workflow", help="Workflow management")
     app.add_typer(tools_app, name="tools", help="Tool management")
-    app.add_typer(knowledge_app, name="knowledge", help="Knowledge base management")
-    app.add_typer(rag_app, name="rag", help="RAG (Retrieval Augmented Generation)")
+    app.add_typer(knowledge_app, name="knowledge", help="Knowledge base management (legacy)")
+    app.add_typer(rag_app, name="rag", help="RAG commands (legacy - use index/query instead)")
+    
+    # Register unified retrieval commands (Agent-first)
+    retrieval_module.register_commands(app)
     app.add_typer(deploy_app, name="deploy", help="Deployment management")
     app.add_typer(agents_app, name="agents", help="Agent management")
     app.add_typer(skills_app, name="skills", help="Skill management")

{praisonai-3.2.0 → praisonai-3.3.0}/praisonai/cli/commands/knowledge.py

@@ -122,6 +122,10 @@ def knowledge_profiler(enabled: bool, profile_out: Optional[Path], profile_top:
 def knowledge_index(
     sources: List[str] = typer.Argument(..., help="Source files, directories, or URLs to index"),
     collection: str = typer.Option("default", "--collection", "-c", help="Collection/knowledge base name"),
+    user_id: Optional[str] = typer.Option(None, "--user-id", "-u", help="User ID for scoping (required for mem0 backend)"),
+    agent_id: Optional[str] = typer.Option(None, "--agent-id", "-a", help="Agent ID for scoping"),
+    run_id: Optional[str] = typer.Option(None, "--run-id", "-r", help="Run ID for scoping"),
+    backend: str = typer.Option("mem0", "--backend", "-b", help="Knowledge backend: mem0, chroma, internal"),
     config: Optional[Path] = typer.Option(None, "--config", "-f", help="Config file path"),
     verbose: bool = typer.Option(False, "--verbose", "-v", help="Verbose output"),
     profile: bool = typer.Option(False, "--profile", help="Enable performance profiling"),
@@ -135,9 +139,9 @@ def knowledge_index(
     Use `praisonai rag query` to answer questions using the indexed knowledge.
     
     Examples:
-        praisonai knowledge index ./docs
-        praisonai knowledge index paper.pdf --collection research
-        praisonai knowledge index ./data --profile --profile-out ./profile.json
+        praisonai knowledge index ./docs --user-id myuser
+        praisonai knowledge index paper.pdf --collection research --agent-id research_agent
+        praisonai knowledge index ./data --backend chroma --profile
     """
     from rich.console import Console
     from rich.progress import Progress, SpinnerColumn, TextColumn
@@ -149,16 +153,34 @@ def knowledge_index(
             # Lazy import to avoid startup cost
             from praisonaiagents.knowledge import Knowledge
             
-            # Build config
-            knowledge_config = {
-                "vector_store": {
-                    "provider": "chroma",
-                    "config": {
-                        "collection_name": collection,
-                        "path": f"./.praison/knowledge/{collection}",
+            # Validate scope for mem0 backend
+            if backend == "mem0" and not any([user_id, agent_id, run_id]):
+                console.print("[yellow]Warning:[/yellow] mem0 backend requires at least one scope identifier.")
+                console.print("Use --user-id, --agent-id, or --run-id to scope your knowledge.")
+                console.print("Defaulting to user_id='default_user'")
+                user_id = "default_user"
+            
+            # Build config based on backend
+            if backend == "chroma":
+                knowledge_config = {
+                    "vector_store": {
+                        "provider": "chroma",
+                        "config": {
+                            "collection_name": collection,
+                            "path": f"./.praison/knowledge/{collection}",
+                        }
+                    }
+                }
+            else:
+                # mem0 or internal backend
+                knowledge_config = {
+                    "vector_store": {
+                        "provider": "qdrant",
+                        "config": {
+                            "collection_name": collection,
+                        }
                     }
                 }
-            }
             
             # Load config file if provided
             if config and config.exists():
@@ -171,7 +193,7 @@ def knowledge_index(
             # Initialize Knowledge
             knowledge = Knowledge(config=knowledge_config, verbose=verbose)
             
-            # Index sources
+            # Index sources with scope identifiers
             with Progress(
                 SpinnerColumn(),
                 TextColumn("[progress.description]{task.description}"),
@@ -181,7 +203,12 @@ def knowledge_index(
                 for source in sources:
                     task = progress.add_task(f"Indexing {source}...", total=None)
                     try:
-                        result = knowledge.add(source)
+                        result = knowledge.add(
+                            source,
+                            user_id=user_id,
+                            agent_id=agent_id,
+                            run_id=run_id,
+                        )
                         count = len(result.get("results", [])) if isinstance(result, dict) else 0
                         console.print(f"[green]✓[/green] Indexed {source}: {count} chunks")
                     except Exception as e:
@@ -207,6 +234,10 @@ def knowledge_index(
 def knowledge_search(
     query: str = typer.Argument(..., help="Search query"),
     collection: str = typer.Option("default", "--collection", "-c", help="Collection to search"),
+    user_id: Optional[str] = typer.Option(None, "--user-id", "-u", help="User ID for scoping (required for mem0 backend)"),
+    agent_id: Optional[str] = typer.Option(None, "--agent-id", "-a", help="Agent ID for scoping"),
+    run_id: Optional[str] = typer.Option(None, "--run-id", "-r", help="Run ID for scoping"),
+    backend: str = typer.Option("mem0", "--backend", "-b", help="Knowledge backend: mem0, chroma, internal"),
     top_k: int = typer.Option(5, "--top-k", "-k", help="Number of results to retrieve"),
     hybrid: bool = typer.Option(False, "--hybrid", help="Use hybrid retrieval (dense + BM25)"),
     config: Optional[Path] = typer.Option(None, "--config", "-f", help="Config file path"),
@@ -222,9 +253,9 @@ def knowledge_search(
     For answers with citations, use `praisonai rag query`.
     
     Examples:
-        praisonai knowledge search "capital of France"
+        praisonai knowledge search "capital of France" --user-id myuser
         praisonai knowledge search "main findings" --collection research --top-k 10
-        praisonai knowledge search "Python tutorial" --hybrid
+        praisonai knowledge search "Python tutorial" --hybrid --backend chroma
     """
     from rich.console import Console
     from rich.table import Table
@@ -235,16 +266,34 @@ def knowledge_search(
         try:
             from praisonaiagents.knowledge import Knowledge
             
-            # Build config
-            knowledge_config = {
-                "vector_store": {
-                    "provider": "chroma",
-                    "config": {
-                        "collection_name": collection,
-                        "path": f"./.praison/knowledge/{collection}",
+            # Validate scope for mem0 backend
+            if backend == "mem0" and not any([user_id, agent_id, run_id]):
+                console.print("[yellow]Warning:[/yellow] mem0 backend requires at least one scope identifier.")
+                console.print("Use --user-id, --agent-id, or --run-id to scope your search.")
+                console.print("Defaulting to user_id='default_user'")
+                user_id = "default_user"
+            
+            # Build config based on backend
+            if backend == "chroma":
+                knowledge_config = {
+                    "vector_store": {
+                        "provider": "chroma",
+                        "config": {
+                            "collection_name": collection,
+                            "path": f"./.praison/knowledge/{collection}",
+                        }
+                    }
+                }
+            else:
+                # mem0 or internal backend
+                knowledge_config = {
+                    "vector_store": {
+                        "provider": "qdrant",
+                        "config": {
+                            "collection_name": collection,
+                        }
                     }
                 }
-            }
             
             # Add hybrid retrieval config if enabled
             if hybrid:
@@ -263,13 +312,19 @@ def knowledge_search(
             # Initialize and search
             knowledge = Knowledge(config=knowledge_config, verbose=verbose)
             
-            # Use hybrid search if enabled
+            # Use hybrid search if enabled, pass scope identifiers
             if hybrid:
                 if verbose:
                     console.print("[dim]Using hybrid retrieval (dense + BM25)...[/dim]")
-                results = knowledge.search(query, limit=top_k, hybrid=True)
+                results = knowledge.search(
+                    query, limit=top_k, hybrid=True,
+                    user_id=user_id, agent_id=agent_id, run_id=run_id,
+                )
             else:
-                results = knowledge.search(query, limit=top_k)
+                results = knowledge.search(
+                    query, limit=top_k,
+                    user_id=user_id, agent_id=agent_id, run_id=run_id,
+                )
             
             if not results:
                 console.print("[yellow]No results found.[/yellow]")
@@ -286,7 +341,9 @@ def knowledge_search(
             for i, result in enumerate(result_list[:top_k], 1):
                 if isinstance(result, dict):
                     score = f"{result.get('score', 0):.3f}" if result.get('score') else "-"
-                    source = result.get('metadata', {}).get('filename', result.get('metadata', {}).get('source', '-'))
+                    # CRITICAL: Handle metadata=None from mem0
+                    metadata = result.get('metadata') or {}
+                    source = metadata.get('filename', metadata.get('source', '-'))
                     content = result.get('memory', result.get('text', ''))[:100] + "..."
                 else:
                     score = "-"