Release v3.9.6

- MemoryConfig from praisonaiagents.config (not memory)
- FileMemory from praisonaiagents.memory
- OutputConfig, ExecutionConfig, PlanningConfig from config

.github/workflows/test-windows.yml

@@ -0,0 +1,204 @@
+name: Windows Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:
+
+jobs:
+  test-windows:
+    runs-on: windows-latest
+    timeout-minutes: 5
+    env:
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      OPENAI_MODEL_NAME: gpt-4o-mini
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.11"
+    
+    - name: Install praisonaiagents
+      run: |
+        python -m pip install --upgrade pip
+        cd src/praisonai-agents
+        pip install .
+      shell: bash
+    
+    - name: Install praisonai wrapper
+      run: |
+        cd src/praisonai
+        pip install .[dev]
+      shell: bash
+
+    # ==================== CORE IMPORTS ====================
+    - name: Test core imports
+      run: |
+        python -c "from praisonaiagents import Agent, Agents, Workflow; print('Core imports OK')"
+        python -c "from praisonaiagents import tool, Tools; print('Tool imports OK')"
+        python -c "from praisonaiagents import Task, WorkflowStep; print('Task/Step imports OK')"
+
+    # ==================== AGENT FEATURES ====================
+    - name: Test Agent instantiation
+      run: |
+        python -c "
+        from praisonaiagents import Agent
+        a = Agent(name='Test', instructions='You are helpful')
+        print('Agent created:', a.name)
+        a2 = Agent(name='ToolAgent', instructions='Use tools', tools=[])
+        print('Agent with tools:', a2.name)
+        "
+
+    - name: Test Agents orchestration
+      run: |
+        python -c "
+        from praisonaiagents import Agent, Agents, Task
+        a1 = Agent(name='Agent1', instructions='First agent')
+        a2 = Agent(name='Agent2', instructions='Second agent')
+        t = Task(description='Do something', agent=a1)
+        agents = Agents(agents=[a1, a2], tasks=[t])
+        print('Agents:', len(agents.agents), 'Tasks:', len(agents.tasks))
+        "
+
+    # ==================== WORKFLOW FEATURES ====================
+    - name: Test Workflow and WorkflowStep
+      run: |
+        python -c "
+        from praisonaiagents import Workflow, WorkflowStep
+        from praisonaiagents.workflows import WorkflowOutputConfig
+        
+        w = Workflow(name='test')
+        s1 = WorkflowStep(name='step1')
+        s2 = WorkflowStep(name='step2', context=['step1'])
+        print('Workflow:', w.name)
+        print('Steps:', s1.name, s2.name)
+        
+        cfg = WorkflowOutputConfig(verbose=True, stream=False)
+        w2 = Workflow(name='configured', output=cfg)
+        print('Configured workflow verbose:', w2.verbose)
+        "
+
+    # ==================== MEMORY FEATURES ====================
+    - name: Test Memory classes
+      run: |
+        python -c "
+        from praisonaiagents.memory import FileMemory
+        from praisonaiagents.config import MemoryConfig
+        
+        cfg = MemoryConfig(backend='file', user_id='test_user')
+        print('MemoryConfig backend:', cfg.backend)
+        
+        mem = FileMemory(user_id='test_user', base_path='.praison/test_memory')
+        print('FileMemory user:', mem.user_id)
+        "
+
+    # ==================== TOOL DECORATOR ====================
+    - name: Test tool decorator
+      run: |
+        python -c "
+        from praisonaiagents import tool
+        
+        @tool
+        def my_tool(query: str) -> str:
+            '''A test tool'''
+            return f'Echo: {query}'
+        
+        result = my_tool('hello')
+        print('Tool result:', result)
+        "
+
+    # ==================== CONFIG CLASSES ====================
+    - name: Test config classes
+      run: |
+        python -c "
+        from praisonaiagents.config import OutputConfig, ExecutionConfig, PlanningConfig
+        
+        out_cfg = OutputConfig(verbose=True, stream=True)
+        print('OutputConfig verbose:', out_cfg.verbose)
+        
+        exec_cfg = ExecutionConfig(max_iter=50, max_retry_limit=5)
+        print('ExecutionConfig max_iter:', exec_cfg.max_iter)
+        
+        plan_cfg = PlanningConfig(reasoning=True, auto_approve=False)
+        print('PlanningConfig reasoning:', plan_cfg.reasoning)
+        "
+    # ==================== HANDOFF ====================
+    - name: Test Handoff
+      run: |
+        python -c "
+        from praisonaiagents import Handoff, handoff, Agent
+        
+        a1 = Agent(name='Agent1', instructions='First')
+        a2 = Agent(name='Agent2', instructions='Second')
+        
+        # Using Handoff class directly
+        h = Handoff(agent=a2)
+        print('Handoff tool name:', h.tool_name)
+        
+        # Using handoff function
+        h2 = handoff(a1, tool_name_override='custom_handoff')
+        print('Custom handoff name:', h2.tool_name)
+        "
+
+
+    # ==================== ASYNC FEATURES ====================
+    - name: Test async imports
+      run: |
+        python -c "
+        import asyncio
+        from praisonaiagents import Agent
+        
+        async def test_async():
+            agent = Agent(name='AsyncAgent', instructions='Test')
+            assert hasattr(agent, 'arun'), 'Missing arun'
+            assert hasattr(agent, 'astart'), 'Missing astart'
+            print('Async methods available')
+        
+        asyncio.run(test_async())
+        "
+
+    # ==================== CLI COMMANDS ====================
+    - name: Test CLI help
+      run: praisonai --help
+
+    - name: Test CLI session list
+      run: praisonai session list
+      continue-on-error: true
+
+    - name: Test CLI queue list
+      run: praisonai queue list
+      continue-on-error: true
+
+    # ==================== REAL API TESTS ====================
+    - name: Real API test - Agent run
+      if: env.OPENAI_API_KEY != ''
+      run: |
+        python -c "
+        from praisonaiagents import Agent
+        agent = Agent(name='TestAgent', instructions='Reply with exactly: WINDOWS_OK', llm='gpt-4o-mini')
+        result = agent.run('Say WINDOWS_OK')
+        print('Result:', result)
+        print('Real API test passed')
+        "
+
+    - name: Real API test - Multi-agent
+      if: env.OPENAI_API_KEY != ''
+      run: |
+        python -c "
+        from praisonaiagents import Agent, Agents, Task
+        
+        researcher = Agent(name='Researcher', instructions='You research topics', llm='gpt-4o-mini')
+        writer = Agent(name='Writer', instructions='You write content', llm='gpt-4o-mini')
+        
+        task = Task(description='Say hello world', agent=researcher)
+        
+        agents = Agents(agents=[researcher, writer], tasks=[task])
+        result = agents.start()
+        print('Multi-agent result type:', type(result))
+        print('Multi-agent test passed')
+        "

.github/workflows/update-api-md.yml

@@ -0,0 +1,57 @@
+name: Update API Reference
+
+on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - 'src/praisonai-agents/praisonaiagents/**/*.py'
+      - 'src/praisonai/praisonai/**/*.py'
+      - 'src/praisonai-ts/src/**/*.ts'
+      - '.github/workflows/update-api-md.yml'
+
+permissions:
+  contents: write
+
+jobs:
+  update-api-md:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        ref: main
+        persist-credentials: true
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Generate api.md
+      run: |
+        cd $GITHUB_WORKSPACE
+        python3 src/praisonai/scripts/generate_api_md.py
+        
+    - name: Check for changes
+      id: check_changes
+      run: |
+        if git diff --quiet api.md; then
+          echo "changes=false" >> $GITHUB_OUTPUT
+          echo "No changes to api.md"
+        else
+          echo "changes=true" >> $GITHUB_OUTPUT
+          echo "api.md has been updated"
+          git diff api.md | head -50
+        fi
+
+    - name: Commit and push changes
+      if: steps.check_changes.outputs.changes == 'true'
+      uses: stefanzweifel/git-auto-commit-action@v5
+      with:
+        commit_message: "docs: auto-update api.md [skip ci]"
+        file_pattern: 'api.md'
+        commit_user_name: "github-actions[bot]"
+        commit_user_email: "41898282+github-actions[bot]@users.noreply.github.com"
+        commit_author: "github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>"

.gitignore

@@ -83,4 +83,5 @@ issue_details.json
 # MCP Registry tokens
 .mcpregistry_*
 
-*.log
+*.log
+.internal

README.md

@@ -23,7 +23,7 @@
 
 </div>
 
-PraisonAI is a production-ready Multi-AI Agents framework with self-reflection, designed to create AI Agents to automate and solve problems ranging from simple tasks to complex challenges. By integrating PraisonAI Agents, AG2 (Formerly AutoGen), and CrewAI into a low-code solution, it streamlines the building and management of multi-agent LLM systems, emphasising simplicity, customisation, and effective human-agent collaboration.
+PraisonAI is a production-ready Multi-AI Agents framework with self-reflection, designed to create AI Agents to automate and solve problems ranging from simple tasks to complex challenges. It provides a low-code solution to streamline the building and management of multi-agent LLM systems, emphasising simplicity, customisation, and effective human-agent collaboration.
 
 <div align="center">
   <a href="https://docs.praison.ai">

api.md

@@ -3,27 +3,11 @@
 This file is auto-generated. Do not edit manually.
 Regenerate with: `praisonai docs api-md --write`
 
-# Shared Types
-
-Types:
-```python
-from praisonaiagents import ContextPolicy, GuardrailResult, HandoffConfig, HandoffCycleError, HandoffDepthError, HandoffError, HandoffInputData, HandoffResult, HandoffTimeoutError, ReflectionOutput, StepResult, TaskOutput, ToolResult, ToolValidationError, WorkflowContext
-```
-
-Methods:
-
-* <code title="class GuardrailResult">GuardrailResult.<a href="./src/praisonai-agents/praisonaiagents/guardrails/guardrail_result.py">from_tuple</a>(result: Tuple[bool, Any]) -> 'GuardrailResult'</code>
-* <code title="class HandoffConfig">HandoffConfig.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">from_dict</a>(data: Dict[str, Any]) -> 'HandoffConfig'</code>
-* <code title="class HandoffConfig">HandoffConfig.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">to_dict</a>() -> Dict[str, Any]</code>
-* <code title="class TaskOutput">TaskOutput.<a href="./src/praisonai-agents/praisonaiagents/main.py">json</a>() -> Optional[str]</code>
-* <code title="class TaskOutput">TaskOutput.<a href="./src/praisonai-agents/praisonaiagents/main.py">to_dict</a>() -> dict</code>
-* <code title="class ToolResult">ToolResult.<a href="./src/praisonai-agents/praisonaiagents/tools/base.py">to_dict</a>() -> Dict[str, Any]</code>
-
 # Agents
 
 Types:
 ```python
-from praisonaiagents import Agent, Agents, AutoAgents, AutoRagAgent, ContextAgent, DeepResearchAgent, ImageAgent, PraisonAIAgents, PromptExpanderAgent, QueryRewriterAgent, create_context_agent
+from praisonaiagents import Agent, Agents
 ```
 
 Methods:
@@ -60,6 +44,7 @@ Methods:
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">get_skills_prompt</a>() -> str</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">handoff_to</a>(target_agent: 'Agent', prompt: str, context: Optional[Dict[str, Any]] = None, config: Optional['HandoffConfig'] = None) -> 'HandoffResult'</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">handoff_to_async</a>(target_agent: 'Agent', prompt: str, context: Optional[Dict[str, Any]] = None, config: Optional['HandoffConfig'] = None) -> 'HandoffResult'</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">iter_stream</a>(prompt: str, **kwargs)</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">launch</a>(path: str = '/', port: int = 8000, host: str = '0.0.0.0', debug: bool = False, protocol: str = 'http')</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">llm_model</a>()</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">output_style</a>()</code>
@@ -76,7 +61,7 @@ Methods:
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">run_autonomous</a>(prompt: str, max_iterations: Optional[int] = None, timeout_seconds: Optional[float] = None)</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">session_id</a>() -> Optional[str]</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">skill_manager</a>()</code>
-* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">start</a>(prompt: str, **kwargs)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">start</a>(prompt: str = None, **kwargs)</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">store_memory</a>(content: str, memory_type: str = 'short_term', **kwargs)</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">switch_model</a>(new_model: str) -> None</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">thinking_budget</a>()</code>
@@ -116,455 +101,31 @@ Methods:
 * <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">save_output_to_file</a>(task, task_output)</code>
 * <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">save_session_state</a>(session_id: str, include_memory: bool = True) -> None</code>
 * <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">set_state</a>(key: str, value: Any) -> None</code>
-* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">start</a>(content = None, return_dict = False, **kwargs)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">start</a>(content = None, return_dict = False, output = None, **kwargs)</code>
 * <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">todo_list</a>()</code>
 * <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">update_plan_step_status</a>(step_id: str, status: str) -> bool</code>
 * <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">update_state</a>(updates: Dict) -> None</code>
-* <code title="class AutoAgents">AutoAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/autoagents.py">astart</a>()</code>
-* <code title="class AutoAgents">AutoAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/autoagents.py">start</a>()</code>
-* <code title="class AutoRagAgent">AutoRagAgent.<a href="./src/praisonai-agents/praisonaiagents/agents/auto_rag_agent.py">achat</a>(message: str, **kwargs) -> str</code>
-* <code title="class AutoRagAgent">AutoRagAgent.<a href="./src/praisonai-agents/praisonaiagents/agents/auto_rag_agent.py">chat</a>(message: str, **kwargs) -> str</code>
-* <code title="class AutoRagAgent">AutoRagAgent.<a href="./src/praisonai-agents/praisonaiagents/agents/auto_rag_agent.py">name</a>() -> str</code>
-* <code title="class AutoRagAgent">AutoRagAgent.<a href="./src/praisonai-agents/praisonaiagents/agents/auto_rag_agent.py">rag</a>() -> Optional['RAG']</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">analyze_codebase_with_gitingest</a>(project_path: str) -> Dict[str, Any]</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">analyze_integration_points</a>(project_path: str) -> Dict[str, Any]</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">analyze_test_patterns</a>(project_path: str) -> Dict[str, Any]</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">build_implementation_blueprint</a>(feature_request: str, context_analysis: Dict[str, Any] = None) -> Dict[str, Any]</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">compile_context_documentation</a>(project_path: str) -> Dict[str, Any]</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">create_quality_gates</a>(requirements: List[str]) -> Dict[str, Any]</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">create_validation_framework</a>(project_path: str) -> Dict[str, Any]</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">execute_prp</a>(prp_file_path: str) -> Dict[str, Any]</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">extract_implementation_patterns</a>(project_path: str, ast_analysis: Dict[str, Any] = None) -> Dict[str, Any]</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">generate_comprehensive_prp</a>(feature_request: str, context_analysis: Dict[str, Any] = None) -> str</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">generate_feature_prp</a>(feature_request: str) -> str</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">get_agent_interaction_summary</a>() -> Dict[str, Any]</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">log_debug</a>(message: str, **kwargs)</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">perform_ast_analysis</a>(project_path: str) -> Dict[str, Any]</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">save_comprehensive_session_report</a>()</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">save_markdown_output</a>(content: str, filename: str, section_title: str = 'Output')</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">setup_logging</a>()</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">setup_output_directories</a>()</code>
-* <code title="class ContextAgent">ContextAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">start</a>(input_text: str) -> str</code>
-* <code title="class DeepResearchAgent">DeepResearchAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/deep_research_agent.py">aresearch</a>(query: str, instructions: Optional[str] = None, model: Optional[str] = None, summary_mode: Optional[Literal['auto', 'detailed', 'concise']] = None, web_search: Optional[bool] = None, code_interpreter: Optional[bool] = None, mcp_servers: Optional[List[Dict[str, Any]]] = None, file_ids: Optional[List[str]] = None, file_search: Optional[bool] = None, file_search_stores: Optional[List[str]] = None) -> DeepResearchResponse</code>
-* <code title="class DeepResearchAgent">DeepResearchAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/deep_research_agent.py">async_openai_client</a>()</code>
-* <code title="class DeepResearchAgent">DeepResearchAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/deep_research_agent.py">clarify</a>(query: str, model: Optional[str] = None) -> str</code>
-* <code title="class DeepResearchAgent">DeepResearchAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/deep_research_agent.py">follow_up</a>(query: str, previous_interaction_id: str, model: Optional[str] = None) -> DeepResearchResponse</code>
-* <code title="class DeepResearchAgent">DeepResearchAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/deep_research_agent.py">gemini_client</a>()</code>
-* <code title="class DeepResearchAgent">DeepResearchAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/deep_research_agent.py">openai_client</a>()</code>
-* <code title="class DeepResearchAgent">DeepResearchAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/deep_research_agent.py">research</a>(query: str, instructions: Optional[str] = None, model: Optional[str] = None, summary_mode: Optional[Literal['auto', 'detailed', 'concise']] = None, web_search: Optional[bool] = None, code_interpreter: Optional[bool] = None, mcp_servers: Optional[List[Dict[str, Any]]] = None, file_ids: Optional[List[str]] = None, file_search: Optional[bool] = None, file_search_stores: Optional[List[str]] = None, stream: bool = True) -> DeepResearchResponse</code>
-* <code title="class DeepResearchAgent">DeepResearchAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/deep_research_agent.py">rewrite_query</a>(query: str, model: Optional[str] = None) -> str</code>
-* <code title="class ImageAgent">ImageAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/image_agent.py">achat</a>(prompt: str, temperature: float = 0.2, tools: Optional[List[Any]] = None, output_json: Optional[str] = None, output_pydantic: Optional[Any] = None, reasoning_steps: bool = False, **kwargs) -> Union[str, Dict[str, Any]]</code>
-* <code title="class ImageAgent">ImageAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/image_agent.py">agenerate_image</a>(prompt: str, **kwargs) -> Dict[str, Any]</code>
-* <code title="class ImageAgent">ImageAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/image_agent.py">chat</a>(prompt: str, **kwargs) -> Dict[str, Any]</code>
-* <code title="class ImageAgent">ImageAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/image_agent.py">generate_image</a>(prompt: str, **kwargs) -> Dict[str, Any]</code>
-* <code title="class ImageAgent">ImageAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/image_agent.py">litellm</a>()</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">add_task</a>(task)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">aexecute_task</a>(task_id)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">append_to_state</a>(key: str, value: Any, max_length: Optional[int] = None) -> List[Any]</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">arun_all_tasks</a>()</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">arun_task</a>(task_id)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">astart</a>(content = None, return_dict = False, **kwargs)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">clean_json_output</a>(output: str) -> str</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">clear_state</a>() -> None</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">context_manager</a>()</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">current_plan</a>()</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">default_completion_checker</a>(task, agent_output)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">delete_state</a>(key: str) -> bool</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">display_token_usage</a>()</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">execute_task</a>(task_id)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_agent_details</a>(agent_name)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_all_state</a>() -> Dict[str, Any]</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_all_tasks_status</a>()</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_detailed_token_report</a>() -> Dict[str, Any]</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_plan_markdown</a>() -> str</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_state</a>(key: str, default: Any = None) -> Any</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_task_details</a>(task_id)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_task_result</a>(task_id)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_task_status</a>(task_id)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_todo_markdown</a>() -> str</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_token_usage_summary</a>() -> Dict[str, Any]</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">has_state</a>(key: str) -> bool</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">increment_state</a>(key: str, amount: float = 1, default: float = 0) -> float</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">launch</a>(path: str = '/agents', port: int = 8000, host: str = '0.0.0.0', debug: bool = False, protocol: str = 'http')</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">restore_session_state</a>(session_id: str) -> bool</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">run</a>(content = None, return_dict = False, **kwargs)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">run_all_tasks</a>()</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">run_task</a>(task_id)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">save_output_to_file</a>(task, task_output)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">save_session_state</a>(session_id: str, include_memory: bool = True) -> None</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">set_state</a>(key: str, value: Any) -> None</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">start</a>(content = None, return_dict = False, **kwargs)</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">todo_list</a>()</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">update_plan_step_status</a>(step_id: str, status: str) -> bool</code>
-* <code title="class PraisonAIAgents">PraisonAIAgents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">update_state</a>(updates: Dict) -> None</code>
-* <code title="class PromptExpanderAgent">PromptExpanderAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/prompt_expander_agent.py">agent</a>()</code>
-* <code title="class PromptExpanderAgent">PromptExpanderAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/prompt_expander_agent.py">expand</a>(prompt: str, strategy: ExpandStrategy = ..., context: Optional[str] = None) -> ExpandResult</code>
-* <code title="class PromptExpanderAgent">PromptExpanderAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/prompt_expander_agent.py">expand_basic</a>(prompt: str, context: Optional[str] = None) -> ExpandResult</code>
-* <code title="class PromptExpanderAgent">PromptExpanderAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/prompt_expander_agent.py">expand_creative</a>(prompt: str, context: Optional[str] = None) -> ExpandResult</code>
-* <code title="class PromptExpanderAgent">PromptExpanderAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/prompt_expander_agent.py">expand_detailed</a>(prompt: str, context: Optional[str] = None) -> ExpandResult</code>
-* <code title="class PromptExpanderAgent">PromptExpanderAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/prompt_expander_agent.py">expand_structured</a>(prompt: str, context: Optional[str] = None) -> ExpandResult</code>
-* <code title="class QueryRewriterAgent">QueryRewriterAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">add_abbreviation</a>(abbrev: str, expansion: str) -> None</code>
-* <code title="class QueryRewriterAgent">QueryRewriterAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">add_abbreviations</a>(abbreviations: Dict[str, str]) -> None</code>
-* <code title="class QueryRewriterAgent">QueryRewriterAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">agent</a>()</code>
-* <code title="class QueryRewriterAgent">QueryRewriterAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">rewrite</a>(query: str, strategy: RewriteStrategy = ..., chat_history: Optional[List[Dict[str, str]]] = None, context: Optional[str] = None, num_queries: int = None) -> RewriteResult</code>
-* <code title="class QueryRewriterAgent">QueryRewriterAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">rewrite_basic</a>(query: str) -> RewriteResult</code>
-* <code title="class QueryRewriterAgent">QueryRewriterAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">rewrite_contextual</a>(query: str, chat_history: List[Dict[str, str]]) -> RewriteResult</code>
-* <code title="class QueryRewriterAgent">QueryRewriterAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">rewrite_hyde</a>(query: str) -> RewriteResult</code>
-* <code title="class QueryRewriterAgent">QueryRewriterAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">rewrite_multi_query</a>(query: str, num_queries: int = None) -> RewriteResult</code>
-* <code title="class QueryRewriterAgent">QueryRewriterAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">rewrite_step_back</a>(query: str) -> RewriteResult</code>
-* <code title="class QueryRewriterAgent">QueryRewriterAgent.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">rewrite_sub_queries</a>(query: str) -> RewriteResult</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/agent/context_agent.py">create_context_agent</a>(llm: Optional[Union[str, Any]] = None, **kwargs) -> ContextAgent</code>
 
 # Tools
 
 Types:
 ```python
-from praisonaiagents import BaseTool, FunctionTool, ToolRegistry, Tools, get_registry, get_tool, register_tool, tool, validate_tool
+from praisonaiagents import Tools, tool
 ```
 
 Methods:
 
-* <code title="class BaseTool">BaseTool.<a href="./src/praisonai-agents/praisonaiagents/tools/base.py">__call__</a>(**kwargs) -> Any</code>
-* <code title="class BaseTool">BaseTool.<a href="./src/praisonai-agents/praisonaiagents/tools/base.py">get_schema</a>() -> Dict[str, Any]</code>
-* <code title="class BaseTool">BaseTool.<a href="./src/praisonai-agents/praisonaiagents/tools/base.py">run</a>(**kwargs) -> Any</code>
-* <code title="class BaseTool">BaseTool.<a href="./src/praisonai-agents/praisonaiagents/tools/base.py">safe_run</a>(**kwargs) -> ToolResult</code>
-* <code title="class BaseTool">BaseTool.<a href="./src/praisonai-agents/praisonaiagents/tools/base.py">validate</a>() -> bool</code>
-* <code title="class BaseTool">BaseTool.<a href="./src/praisonai-agents/praisonaiagents/tools/base.py">validate_class</a>() -> bool</code>
-* <code title="class FunctionTool">FunctionTool.<a href="./src/praisonai-agents/praisonaiagents/tools/decorator.py">__call__</a>(*args, **kwargs) -> Any</code>
-* <code title="class FunctionTool">FunctionTool.<a href="./src/praisonai-agents/praisonaiagents/tools/decorator.py">injected_params</a>() -> Dict[str, Any]</code>
-* <code title="class FunctionTool">FunctionTool.<a href="./src/praisonai-agents/praisonaiagents/tools/decorator.py">run</a>(**kwargs) -> Any</code>
-* <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">clear</a>() -> None</code>
-* <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">discover_plugins</a>() -> int</code>
-* <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">get</a>(name: str) -> Optional[Union[BaseTool, Callable]]</code>
-* <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">get_all</a>() -> Dict[str, Union[BaseTool, Callable]]</code>
-* <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">list_base_tools</a>() -> List[BaseTool]</code>
-* <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">list_tools</a>() -> List[str]</code>
-* <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">register</a>(tool: Union[BaseTool, Callable], name: Optional[str] = None, overwrite: bool = False) -> None</code>
-* <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">unregister</a>(name: str) -> bool</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">get_registry</a>() -> ToolRegistry</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">get_tool</a>(name: str) -> Optional[Union[BaseTool, Callable]]</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">register_tool</a>(tool: Union[BaseTool, Callable], name: Optional[str] = None) -> None</code>
 * <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/tools/decorator.py">tool</a>(func: Optional[Callable] = None) -> Union[FunctionTool, Callable[[Callable], FunctionTool]]</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/tools/base.py">validate_tool</a>(tool: Any) -> bool</code>
-
-# Workflows
-
-Types:
-```python
-from praisonaiagents import Loop, Parallel, Pipeline, Repeat, Route, Workflow, WorkflowStep, loop, parallel, repeat, route
-```
-
-Methods:
-
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">arun</a>(input: str = '', llm: Optional[str] = None, verbose: bool = False) -> Dict[str, Any]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">astart</a>(input: str = '', llm: Optional[str] = None, verbose: bool = False) -> Dict[str, Any]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">from_template</a>(uri: str, config: Optional[Dict[str, Any]] = None, offline: bool = False, **kwargs) -> 'Workflow'</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">memory_config</a>() -> Optional[Dict[str, Any]]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">on_step_complete</a>() -> Optional[Callable]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">on_step_error</a>() -> Optional[Callable]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">on_step_start</a>() -> Optional[Callable]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">on_workflow_complete</a>() -> Optional[Callable]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">on_workflow_start</a>() -> Optional[Callable]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">planning_llm</a>() -> Optional[str]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">reasoning</a>() -> bool</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">run</a>(input: str = '', llm: Optional[str] = None, verbose: bool = False, stream: bool = None) -> Dict[str, Any]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">start</a>(input: str = '', **kwargs) -> Dict[str, Any]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">stream</a>() -> bool</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">to_dict</a>() -> Dict[str, Any]</code>
-* <code title="class Workflow">Workflow.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">verbose</a>() -> bool</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">async_execution</a>() -> bool</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">branch_condition</a>() -> Optional[Dict[str, List[str]]]</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">context_from</a>() -> Optional[List[str]]</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">evaluator</a>()</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">executor</a>()</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">max_retries</a>() -> int</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">next_steps</a>() -> Optional[List[str]]</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">on_error</a>() -> str</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">output_file</a>() -> Optional[str]</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">output_json</a>() -> Optional[Any]</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">output_pydantic</a>() -> Optional[Any]</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">output_variable</a>() -> Optional[str]</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">quality_check</a>() -> bool</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">rerun</a>() -> bool</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">retain_full_context</a>() -> bool</code>
-* <code title="class WorkflowStep">WorkflowStep.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">to_dict</a>() -> Dict[str, Any]</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">loop</a>(step: Any, over: Optional[str] = None, from_csv: Optional[str] = None, from_file: Optional[str] = None, var_name: str = 'item') -> Loop</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">parallel</a>(steps: List) -> Parallel</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">repeat</a>(step: Any, until: Optional[Callable[[WorkflowContext], bool]] = None, max_iterations: int = 10) -> Repeat</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/workflows/workflows.py">route</a>(routes: Dict[str, List], default: Optional[List] = None) -> Route</code>
-
-# DB
-
-Types:
-```python
-from praisonaiagents import db
-```
-
-# Memory
-
-Types:
-```python
-from praisonaiagents import Memory
-```
-
-Methods:
-
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">build_context_for_task</a>(task_descr: str, user_id: Optional[str] = None, additional: str = '', max_items: int = 3, include_in_output: Optional[bool] = None) -> str</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">calculate_quality_metrics</a>(output: str, expected_output: str, llm: Optional[str] = None, custom_prompt: Optional[str] = None) -> Dict[str, float]</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">compute_quality_score</a>(completeness: float, relevance: float, clarity: float, accuracy: float, weights: Dict[str, float] = None) -> float</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">finalize_task_output</a>(content: str, agent_name: str, quality_score: float, threshold: float = 0.7, metrics: Dict[str, Any] = None, task_id: str = None)</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">get_all_memories</a>() -> List[Dict[str, Any]]</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">reset_all</a>()</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">reset_entity_only</a>()</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">reset_long_term</a>()</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">reset_short_term</a>()</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">reset_user_memory</a>()</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">search</a>(query: str, user_id: Optional[str] = None, agent_id: Optional[str] = None, run_id: Optional[str] = None, limit: int = 5, rerank: bool = False, **kwargs) -> List[Dict[str, Any]]</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">search_entity</a>(query: str, limit: int = 5) -> List[Dict[str, Any]]</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">search_long_term</a>(query: str, limit: int = 5, relevance_cutoff: float = 0.0, min_quality: float = 0.0, rerank: bool = False, **kwargs) -> List[Dict[str, Any]]</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">search_short_term</a>(query: str, limit: int = 5, min_quality: float = 0.0, relevance_cutoff: float = 0.0, rerank: bool = False, **kwargs) -> List[Dict[str, Any]]</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">search_user_memory</a>(user_id: str, query: str, limit: int = 5, rerank: bool = False, **kwargs) -> List[Dict[str, Any]]</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">search_with_quality</a>(query: str, min_quality: float = 0.0, memory_type: Literal['short', 'long'] = 'long', limit: int = 5) -> List[Dict[str, Any]]</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">store_entity</a>(name: str, type_: str, desc: str, relations: str)</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">store_long_term</a>(text: str, metadata: Dict[str, Any] = None, completeness: float = None, relevance: float = None, clarity: float = None, accuracy: float = None, weights: Dict[str, float] = None, evaluator_quality: float = None)</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">store_quality</a>(text: str, quality_score: float, task_id: Optional[str] = None, iteration: Optional[int] = None, metrics: Optional[Dict[str, float]] = None, memory_type: Literal['short', 'long'] = 'long') -> None</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">store_short_term</a>(text: str, metadata: Dict[str, Any] = None, completeness: float = None, relevance: float = None, clarity: float = None, accuracy: float = None, weights: Dict[str, float] = None, evaluator_quality: float = None)</code>
-* <code title="class Memory">Memory.<a href="./src/praisonai-agents/praisonaiagents/memory/memory.py">store_user_memory</a>(user_id: str, text: str, extra: Dict[str, Any] = None)</code>
-
-# Knowledge
-
-Types:
-```python
-from praisonaiagents import Chunking, Knowledge
-```
-
-Methods:
-
-* <code title="class Chunking">Chunking.<a href="./src/praisonai-agents/praisonaiagents/knowledge/chunking.py">SUPPORTED_CHUNKERS</a>() -> Dict[str, Any]</code>
-* <code title="class Chunking">Chunking.<a href="./src/praisonai-agents/praisonaiagents/knowledge/chunking.py">__call__</a>(text: Union[str, List[str]], **kwargs) -> Union[List[Any], List[List[Any]]]</code>
-* <code title="class Chunking">Chunking.<a href="./src/praisonai-agents/praisonaiagents/knowledge/chunking.py">chunk</a>(text: Union[str, List[str]], **kwargs) -> Union[List[Any], List[List[Any]]]</code>
-* <code title="class Chunking">Chunking.<a href="./src/praisonai-agents/praisonaiagents/knowledge/chunking.py">chunker</a>()</code>
-* <code title="class Chunking">Chunking.<a href="./src/praisonai-agents/praisonaiagents/knowledge/chunking.py">embedding_model</a>()</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">add</a>(file_path, user_id = None, agent_id = None, run_id = None, metadata = None)</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">chunker</a>()</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">config</a>()</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">delete</a>(memory_id)</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">delete_all</a>(user_id = None, agent_id = None, run_id = None)</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">get</a>(memory_id)</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">get_all</a>(user_id = None, agent_id = None, run_id = None)</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">get_corpus_stats</a>()</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">history</a>(memory_id)</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">index</a>(path: str, incremental: bool = True, force: bool = False, include_glob: list = None, exclude_glob: list = None, user_id: str = None, agent_id: str = None, run_id: str = None)</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">markdown</a>()</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">memory</a>()</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">normalize_content</a>(content)</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">reset</a>()</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">search</a>(query, user_id = None, agent_id = None, run_id = None, rerank = None, **kwargs)</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">store</a>(content, user_id = None, agent_id = None, run_id = None, metadata = None)</code>
-* <code title="class Knowledge">Knowledge.<a href="./src/praisonai-agents/praisonaiagents/knowledge/knowledge.py">update</a>(memory_id, data)</code>
-
-# RAG
-
-Types:
-```python
-from praisonaiagents import RAG, RAGCitation, RAGConfig, RAGResult
-```
-
-Methods:
-
-* <code title="class RAG">RAG.<a href="./src/praisonai-agents/praisonaiagents/rag/pipeline.py">aquery</a>(question: str, user_id: Optional[str] = None, agent_id: Optional[str] = None, run_id: Optional[str] = None, **kwargs) -> RAGResult</code>
-* <code title="class RAG">RAG.<a href="./src/praisonai-agents/praisonaiagents/rag/pipeline.py">aretrieve</a>(query: str, **kwargs) -> ContextPack</code>
-* <code title="class RAG">RAG.<a href="./src/praisonai-agents/praisonaiagents/rag/pipeline.py">astream</a>(question: str, user_id: Optional[str] = None, agent_id: Optional[str] = None, run_id: Optional[str] = None, **kwargs) -> AsyncIterator[str]</code>
-* <code title="class RAG">RAG.<a href="./src/praisonai-agents/praisonaiagents/rag/pipeline.py">get_citations</a>(question: str, user_id: Optional[str] = None, agent_id: Optional[str] = None, run_id: Optional[str] = None, **kwargs) -> List[Citation]</code>
-* <code title="class RAG">RAG.<a href="./src/praisonai-agents/praisonaiagents/rag/pipeline.py">llm</a>()</code>
-* <code title="class RAG">RAG.<a href="./src/praisonai-agents/praisonaiagents/rag/pipeline.py">query</a>(question: str, user_id: Optional[str] = None, agent_id: Optional[str] = None, run_id: Optional[str] = None, **kwargs) -> RAGResult</code>
-* <code title="class RAG">RAG.<a href="./src/praisonai-agents/praisonaiagents/rag/pipeline.py">retrieve</a>(query: str, **kwargs) -> ContextPack</code>
-* <code title="class RAG">RAG.<a href="./src/praisonai-agents/praisonaiagents/rag/pipeline.py">stream</a>(question: str, user_id: Optional[str] = None, agent_id: Optional[str] = None, run_id: Optional[str] = None, **kwargs) -> Iterator[str]</code>
-* <code title="class RAGCitation">RAGCitation.<a href="./src/praisonai-agents/praisonaiagents/rag/models.py">from_dict</a>(data: Dict[str, Any]) -> 'Citation'</code>
-* <code title="class RAGCitation">RAGCitation.<a href="./src/praisonai-agents/praisonaiagents/rag/models.py">to_dict</a>() -> Dict[str, Any]</code>
-* <code title="class RAGConfig">RAGConfig.<a href="./src/praisonai-agents/praisonaiagents/rag/models.py">from_dict</a>(data: Dict[str, Any]) -> 'RAGConfig'</code>
-* <code title="class RAGConfig">RAGConfig.<a href="./src/praisonai-agents/praisonaiagents/rag/models.py">to_dict</a>() -> Dict[str, Any]</code>
-* <code title="class RAGResult">RAGResult.<a href="./src/praisonai-agents/praisonaiagents/rag/models.py">format_answer_with_citations</a>() -> str</code>
-* <code title="class RAGResult">RAGResult.<a href="./src/praisonai-agents/praisonaiagents/rag/models.py">from_dict</a>(data: Dict[str, Any]) -> 'RAGResult'</code>
-* <code title="class RAGResult">RAGResult.<a href="./src/praisonai-agents/praisonaiagents/rag/models.py">has_citations</a>() -> bool</code>
-* <code title="class RAGResult">RAGResult.<a href="./src/praisonai-agents/praisonaiagents/rag/models.py">to_dict</a>() -> Dict[str, Any]</code>
-
-# Handoff
-
-Types:
-```python
-from praisonaiagents import Handoff, RECOMMENDED_PROMPT_PREFIX, handoff, handoff_filters, prompt_with_handoff_instructions
-```
-
-Methods:
-
-* <code title="class Handoff">Handoff.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">default_tool_description</a>() -> str</code>
-* <code title="class Handoff">Handoff.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">default_tool_name</a>() -> str</code>
-* <code title="class Handoff">Handoff.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">execute_async</a>(source_agent: 'Agent', prompt: str, context: Optional[Dict[str, Any]] = None) -> HandoffResult</code>
-* <code title="class Handoff">Handoff.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">execute_programmatic</a>(source_agent: 'Agent', prompt: str, context: Optional[Dict[str, Any]] = None) -> HandoffResult</code>
-* <code title="class Handoff">Handoff.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">to_tool_function</a>(source_agent: 'Agent') -> Callable</code>
-* <code title="class Handoff">Handoff.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">tool_description</a>() -> str</code>
-* <code title="class Handoff">Handoff.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">tool_name</a>() -> str</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">handoff</a>(agent: 'Agent', tool_name_override: Optional[str] = None, tool_description_override: Optional[str] = None, on_handoff: Optional[Callable] = None, input_type: Optional[type] = None, input_filter: Optional[Callable[[HandoffInputData], HandoffInputData]] = None, config: Optional[HandoffConfig] = None, context_policy: Optional[str] = None, timeout_seconds: Optional[float] = None, max_concurrent: Optional[int] = None, detect_cycles: Optional[bool] = None, max_depth: Optional[int] = None) -> Handoff</code>
-* <code title="class handoff_filters">handoff_filters.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">keep_last_n_messages</a>(n: int) -> Callable[[HandoffInputData], HandoffInputData]</code>
-* <code title="class handoff_filters">handoff_filters.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">remove_all_tools</a>(data: HandoffInputData) -> HandoffInputData</code>
-* <code title="class handoff_filters">handoff_filters.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">remove_system_messages</a>(data: HandoffInputData) -> HandoffInputData</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/agent/handoff.py">prompt_with_handoff_instructions</a>(base_prompt: str, agent: 'Agent') -> str</code>
-
-# Guardrails
-
-Types:
-```python
-from praisonaiagents import LLMGuardrail
-```
-
-Methods:
-
-* <code title="class LLMGuardrail">LLMGuardrail.<a href="./src/praisonai-agents/praisonaiagents/guardrails/llm_guardrail.py">__call__</a>(task_output: TaskOutput) -> Tuple[bool, Union[str, TaskOutput]]</code>
-
-# Skills
-
-Types:
-```python
-from praisonaiagents import SkillLoader, SkillManager, SkillMetadata, SkillProperties
-```
-
-Methods:
-
-* <code title="class SkillLoader">SkillLoader.<a href="./src/praisonai-agents/praisonaiagents/skills/loader.py">activate</a>(skill: LoadedSkill) -> bool</code>
-* <code title="class SkillLoader">SkillLoader.<a href="./src/praisonai-agents/praisonaiagents/skills/loader.py">load</a>(skill_path: str, activate: bool = False) -> Optional[LoadedSkill]</code>
-* <code title="class SkillLoader">SkillLoader.<a href="./src/praisonai-agents/praisonaiagents/skills/loader.py">load_all_resources</a>(skill: LoadedSkill) -> None</code>
-* <code title="class SkillLoader">SkillLoader.<a href="./src/praisonai-agents/praisonaiagents/skills/loader.py">load_assets</a>(skill: LoadedSkill) -> dict</code>
-* <code title="class SkillLoader">SkillLoader.<a href="./src/praisonai-agents/praisonaiagents/skills/loader.py">load_metadata</a>(skill_path: str) -> Optional[LoadedSkill]</code>
-* <code title="class SkillLoader">SkillLoader.<a href="./src/praisonai-agents/praisonaiagents/skills/loader.py">load_references</a>(skill: LoadedSkill) -> dict</code>
-* <code title="class SkillLoader">SkillLoader.<a href="./src/praisonai-agents/praisonaiagents/skills/loader.py">load_scripts</a>(skill: LoadedSkill) -> dict</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">activate</a>(skill: LoadedSkill) -> bool</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">activate_by_name</a>(name: str) -> bool</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">add_skill</a>(skill_path: str) -> Optional[LoadedSkill]</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">clear</a>() -> None</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">discover</a>(skill_dirs: Optional[List[str]] = None, include_defaults: bool = True) -> int</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">get_available_skills</a>() -> List[SkillMetadata]</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">get_instructions</a>(name: str) -> Optional[str]</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">get_skill</a>(name: str) -> Optional[LoadedSkill]</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">load_resources</a>(name: str) -> bool</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">skill_names</a>() -> List[str]</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">skills</a>() -> List[LoadedSkill]</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">to_prompt</a>() -> str</code>
-* <code title="class SkillMetadata">SkillMetadata.<a href="./src/praisonai-agents/praisonaiagents/skills/models.py">from_properties</a>(props: SkillProperties) -> 'SkillMetadata'</code>
-* <code title="class SkillProperties">SkillProperties.<a href="./src/praisonai-agents/praisonaiagents/skills/models.py">to_dict</a>() -> dict</code>
-
-# Session
-
-Types:
-```python
-from praisonaiagents import Session
-```
-
-Methods:
-
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">Agent</a>(name: str, role: str = 'Assistant', instructions: Optional[str] = None, tools: Optional[List[Any]] = None, memory: bool = True, knowledge: Optional[List[str]] = None, **kwargs) -> 'Agent'</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">add_knowledge</a>(source: str) -> None</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">add_memory</a>(text: str, memory_type: str = 'long', **metadata) -> None</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">chat</a>(message: str, **kwargs) -> str</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">clear_memory</a>(memory_type: str = 'all') -> None</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">create_agent</a>(*args, **kwargs) -> 'Agent'</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">get_context</a>(query: str, max_items: int = 3) -> str</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">get_state</a>(key: str, default: Any = None) -> Any</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">increment_state</a>(key: str, increment: int = 1, default: int = 0) -> None</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">knowledge</a>() -> 'Knowledge'</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">memory</a>() -> 'Memory'</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">restore_state</a>() -> Dict[str, Any]</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">save_state</a>(state_data: Dict[str, Any]) -> None</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">search_knowledge</a>(query: str, limit: int = 5) -> List[Dict[str, Any]]</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">search_memory</a>(query: str, memory_type: str = 'long', limit: int = 5) -> List[Dict[str, Any]]</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">send_message</a>(message: str, **kwargs) -> str</code>
-* <code title="class Session">Session.<a href="./src/praisonai-agents/praisonaiagents/session/api.py">set_state</a>(key: str, value: Any) -> None</code>
-
-# Telemetry
-
-Types:
-```python
-from praisonaiagents import get_telemetry
-```
-
-Methods:
-
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/telemetry/__init__.py">get_telemetry</a>() -> 'MinimalTelemetry'</code>
-
-# Observability
-
-Types:
-```python
-from praisonaiagents import FlowDisplay, obs, track_workflow
-```
-
-Methods:
-
-* <code title="class FlowDisplay">FlowDisplay.<a href="./src/praisonai-agents/praisonaiagents/flow_display.py">display</a>()</code>
-* <code title="class FlowDisplay">FlowDisplay.<a href="./src/praisonai-agents/praisonaiagents/flow_display.py">start</a>()</code>
-* <code title="class FlowDisplay">FlowDisplay.<a href="./src/praisonai-agents/praisonaiagents/flow_display.py">stop</a>()</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/flow_display.py">track_workflow</a>()</code>
-
-# Context
-
-Types:
-```python
-from praisonaiagents import ContextManager, ManagerConfig
-```
-
-Methods:
-
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">capture_llm_boundary</a>(messages: List[Dict[str, Any]], tools: List[Dict[str, Any]]) -> SnapshotHookData</code>
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">estimate_tokens</a>(text: str, validate: bool = False) -> Tuple[int, Optional[EstimationMetrics]]</code>
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">get_history</a>() -> List[Dict[str, Any]]</code>
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">get_last_snapshot_hook</a>() -> Optional[SnapshotHookData]</code>
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">get_resolved_config</a>() -> Dict[str, Any]</code>
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">get_stats</a>() -> Dict[str, Any]</code>
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">get_tool_budget</a>(tool_name: str) -> int</code>
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">process</a>(messages: List[Dict[str, Any]], system_prompt: str = '', tools: Optional[List[Dict[str, Any]]] = None, trigger: Literal['turn', 'tool_call', 'manual', 'overflow'] = 'turn') -> Dict[str, Any]</code>
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">register_snapshot_callback</a>(callback: Callable[[SnapshotHookData], None]) -> None</code>
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">reset</a>() -> None</code>
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">set_tool_budget</a>(tool_name: str, max_tokens: int, protected: bool = False) -> None</code>
-* <code title="class ContextManager">ContextManager.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">truncate_tool_output</a>(tool_name: str, output: str) -> str</code>
-* <code title="class ManagerConfig">ManagerConfig.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">from_env</a>() -> 'ManagerConfig'</code>
-* <code title="class ManagerConfig">ManagerConfig.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">merge</a>(**overrides) -> 'ManagerConfig'</code>
-* <code title="class ManagerConfig">ManagerConfig.<a href="./src/praisonai-agents/praisonaiagents/context/manager.py">to_dict</a>() -> Dict[str, Any]</code>
-
-# Display
-
-Types:
-```python
-from praisonaiagents import async_display_callbacks, clean_triple_backticks, display_error, display_generating, display_instruction, display_interaction, display_self_reflection, display_tool_call, error_logs, register_display_callback, sync_display_callbacks
-```
-
-Methods:
-
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/main.py">clean_triple_backticks</a>(text: str) -> str</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/main.py">display_error</a>(message: str, console = None)</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/main.py">display_generating</a>(content: str = '', start_time: Optional[float] = None)</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/main.py">display_instruction</a>(message: str, console = None, agent_name: str = None, agent_role: str = None, agent_tools: List[str] = None)</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/main.py">display_interaction</a>(message, response, markdown = True, generation_time = None, console = None, agent_name = None, agent_role = None, agent_tools = None, task_name = None, task_description = None, task_id = None)</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/main.py">display_self_reflection</a>(message: str, console = None)</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/main.py">display_tool_call</a>(message: str, console = None, tool_name: str = None, tool_input: dict = None, tool_output: str = None)</code>
-* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/main.py">register_display_callback</a>(display_type: str, callback_fn, is_async: bool = False)</code>
 
 # Other
 
 Types:
 ```python
-from praisonaiagents import AutoRagConfig, Citation, CodeExecutionStep, DeepResearchResponse, ExpandResult, ExpandStrategy, FileSearchCall, MCPCall, Provider, RagRetrievalPolicy, ReasoningStep, RewriteResult, RewriteStrategy, Task, WebSearchCall
+from praisonaiagents import Task
 ```
 
 Methods:
 
-* <code title="class AutoRagConfig">AutoRagConfig.<a href="./src/praisonai-agents/praisonaiagents/agents/auto_rag_agent.py">from_dict</a>(data: Dict[str, Any]) -> 'AutoRagConfig'</code>
-* <code title="class AutoRagConfig">AutoRagConfig.<a href="./src/praisonai-agents/praisonaiagents/agents/auto_rag_agent.py">to_dict</a>() -> Dict[str, Any]</code>
-* <code title="class Citation">Citation.<a href="./src/praisonai-agents/praisonaiagents/rag/models.py">from_dict</a>(data: Dict[str, Any]) -> 'Citation'</code>
-* <code title="class Citation">Citation.<a href="./src/praisonai-agents/praisonaiagents/rag/models.py">to_dict</a>() -> Dict[str, Any]</code>
-* <code title="class DeepResearchResponse">DeepResearchResponse.<a href="./src/praisonai-agents/praisonaiagents/agent/deep_research_agent.py">get_all_sources</a>() -> List[Dict[str, str]]</code>
-* <code title="class DeepResearchResponse">DeepResearchResponse.<a href="./src/praisonai-agents/praisonaiagents/agent/deep_research_agent.py">get_citation_text</a>(citation: Citation) -> str</code>
-* <code title="class RewriteResult">RewriteResult.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">all_queries</a>() -> List[str]</code>
-* <code title="class RewriteResult">RewriteResult.<a href="./src/praisonai-agents/praisonaiagents/agent/query_rewriter_agent.py">primary_query</a>() -> str</code>
 * <code title="class Task">Task.<a href="./src/praisonai-agents/praisonaiagents/task/task.py">execute_callback</a>(task_output: TaskOutput) -> None</code>
 * <code title="class Task">Task.<a href="./src/praisonai-agents/praisonaiagents/task/task.py">execute_callback_sync</a>(task_output: TaskOutput) -> None</code>
 * <code title="class Task">Task.<a href="./src/praisonai-agents/praisonaiagents/task/task.py">initialize_memory</a>()</code>
@@ -587,6 +148,10 @@ Methods:
 * <code title="cli">praisonai agents info <a href="./src/praisonai/praisonai/cli/commands/agents.py">--help</a></code>
 * <code title="cli">praisonai agents list <a href="./src/praisonai/praisonai/cli/commands/agents.py">--help</a></code>
 * <code title="cli">praisonai audit agent-centric <a href="./src/praisonai/praisonai/cli/commands/audit.py">--help</a></code>
+* <code title="cli">praisonai batch batch-run <a href="./src/praisonai/praisonai/cli/commands/batch.py">--help</a></code>
+* <code title="cli">praisonai batch list <a href="./src/praisonai/praisonai/cli/commands/batch.py">--help</a></code>
+* <code title="cli">praisonai batch report <a href="./src/praisonai/praisonai/cli/commands/batch.py">--help</a></code>
+* <code title="cli">praisonai batch stats <a href="./src/praisonai/praisonai/cli/commands/batch.py">--help</a></code>
 * <code title="cli">praisonai benchmark agent <a href="./src/praisonai/praisonai/cli/commands/benchmark.py">--help</a></code>
 * <code title="cli">praisonai benchmark benchmark-callback <a href="./src/praisonai/praisonai/cli/commands/benchmark.py">--help</a></code>
 * <code title="cli">praisonai benchmark cli <a href="./src/praisonai/praisonai/cli/commands/benchmark.py">--help</a></code>
@@ -614,8 +179,11 @@ Methods:
 * <code title="cli">praisonai context clear <a href="./src/praisonai/praisonai/cli/commands/context.py">--help</a></code>
 * <code title="cli">praisonai context compact <a href="./src/praisonai/praisonai/cli/commands/context.py">--help</a></code>
 * <code title="cli">praisonai context export <a href="./src/praisonai/praisonai/cli/commands/context.py">--help</a></code>
+* <code title="cli">praisonai context grep <a href="./src/praisonai/praisonai/cli/commands/context.py">--help</a></code>
+* <code title="cli">praisonai context list <a href="./src/praisonai/praisonai/cli/commands/context.py">--help</a></code>
 * <code title="cli">praisonai context show <a href="./src/praisonai/praisonai/cli/commands/context.py">--help</a></code>
 * <code title="cli">praisonai context stats <a href="./src/praisonai/praisonai/cli/commands/context.py">--help</a></code>
+* <code title="cli">praisonai context tail <a href="./src/praisonai/praisonai/cli/commands/context.py">--help</a></code>
 * <code title="cli">praisonai debug acp <a href="./src/praisonai/praisonai/cli/commands/debug.py">--help</a></code>
 * <code title="cli">praisonai debug debug-callback <a href="./src/praisonai/praisonai/cli/commands/debug.py">--help</a></code>
 * <code title="cli">praisonai debug interactive <a href="./src/praisonai/praisonai/cli/commands/debug.py">--help</a></code>
@@ -635,6 +203,7 @@ Methods:
 * <code title="cli">praisonai docs run-all <a href="./src/praisonai/praisonai/cli/commands/docs.py">--help</a></code>
 * <code title="cli">praisonai docs serve <a href="./src/praisonai/praisonai/cli/commands/docs.py">--help</a></code>
 * <code title="cli">praisonai docs stats <a href="./src/praisonai/praisonai/cli/commands/docs.py">--help</a></code>
+* <code title="cli">praisonai doctor cleanup <a href="./src/praisonai/praisonai/cli/commands/doctor.py">--help</a></code>
 * <code title="cli">praisonai doctor config <a href="./src/praisonai/praisonai/cli/commands/doctor.py">--help</a></code>
 * <code title="cli">praisonai doctor db <a href="./src/praisonai/praisonai/cli/commands/doctor.py">--help</a></code>
 * <code title="cli">praisonai doctor doctor-callback <a href="./src/praisonai/praisonai/cli/commands/doctor.py">--help</a></code>
@@ -644,6 +213,7 @@ Methods:
 * <code title="cli">praisonai doctor performance <a href="./src/praisonai/praisonai/cli/commands/doctor.py">--help</a></code>
 * <code title="cli">praisonai doctor selftest <a href="./src/praisonai/praisonai/cli/commands/doctor.py">--help</a></code>
 * <code title="cli">praisonai doctor tools <a href="./src/praisonai/praisonai/cli/commands/doctor.py">--help</a></code>
+* <code title="cli">praisonai doctor troubleshoot <a href="./src/praisonai/praisonai/cli/commands/doctor.py">--help</a></code>
 * <code title="cli">praisonai endpoints list <a href="./src/praisonai/praisonai/cli/commands/endpoints.py">--help</a></code>
 * <code title="cli">praisonai endpoints test <a href="./src/praisonai/praisonai/cli/commands/endpoints.py">--help</a></code>
 * <code title="cli">praisonai environment check <a href="./src/praisonai/praisonai/cli/commands/environment.py">--help</a></code>
@@ -670,14 +240,20 @@ Methods:
 * <code title="cli">praisonai lsp status <a href="./src/praisonai/praisonai/cli/commands/lsp.py">--help</a></code>
 * <code title="cli">praisonai lsp stop <a href="./src/praisonai/praisonai/cli/commands/lsp.py">--help</a></code>
 * <code title="cli">praisonai mcp add <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp describe <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
 * <code title="cli">praisonai mcp list <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
 * <code title="cli">praisonai mcp mcp-callback <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
 * <code title="cli">praisonai mcp remove <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp run <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp status <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp sync <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
 * <code title="cli">praisonai mcp test <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp tools <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
 * <code title="cli">praisonai memory add <a href="./src/praisonai/praisonai/cli/commands/memory.py">--help</a></code>
 * <code title="cli">praisonai memory clear <a href="./src/praisonai/praisonai/cli/commands/memory.py">--help</a></code>
 * <code title="cli">praisonai memory search <a href="./src/praisonai/praisonai/cli/commands/memory.py">--help</a></code>
 * <code title="cli">praisonai memory show <a href="./src/praisonai/praisonai/cli/commands/memory.py">--help</a></code>
+* <code title="cli">praisonai memory status <a href="./src/praisonai/praisonai/cli/commands/memory.py">--help</a></code>
 * <code title="cli">praisonai package install <a href="./src/praisonai/praisonai/cli/commands/package.py">--help</a></code>
 * <code title="cli">praisonai package list <a href="./src/praisonai/praisonai/cli/commands/package.py">--help</a></code>
 * <code title="cli">praisonai package uninstall <a href="./src/praisonai/praisonai/cli/commands/package.py">--help</a></code>
@@ -728,12 +304,19 @@ Methods:
 * <code title="cli">praisonai session resume <a href="./src/praisonai/praisonai/cli/commands/session.py">--help</a></code>
 * <code title="cli">praisonai session show <a href="./src/praisonai/praisonai/cli/commands/session.py">--help</a></code>
 * <code title="cli">praisonai skills create <a href="./src/praisonai/praisonai/cli/commands/skills.py">--help</a></code>
+* <code title="cli">praisonai skills info <a href="./src/praisonai/praisonai/cli/commands/skills.py">--help</a></code>
 * <code title="cli">praisonai skills install <a href="./src/praisonai/praisonai/cli/commands/skills.py">--help</a></code>
 * <code title="cli">praisonai skills list <a href="./src/praisonai/praisonai/cli/commands/skills.py">--help</a></code>
+* <code title="cli">praisonai skills search <a href="./src/praisonai/praisonai/cli/commands/skills.py">--help</a></code>
 * <code title="cli">praisonai skills validate <a href="./src/praisonai/praisonai/cli/commands/skills.py">--help</a></code>
+* <code title="cli">praisonai standardise check <a href="./src/praisonai/praisonai/cli/commands/standardise.py">--help</a></code>
+* <code title="cli">praisonai standardise fix <a href="./src/praisonai/praisonai/cli/commands/standardise.py">--help</a></code>
+* <code title="cli">praisonai standardise init <a href="./src/praisonai/praisonai/cli/commands/standardise.py">--help</a></code>
+* <code title="cli">praisonai standardise report <a href="./src/praisonai/praisonai/cli/commands/standardise.py">--help</a></code>
 * <code title="cli">praisonai templates create <a href="./src/praisonai/praisonai/cli/commands/templates.py">--help</a></code>
 * <code title="cli">praisonai templates list <a href="./src/praisonai/praisonai/cli/commands/templates.py">--help</a></code>
 * <code title="cli">praisonai test info <a href="./src/praisonai/praisonai/cli/commands/test.py">--help</a></code>
+* <code title="cli">praisonai test interactive <a href="./src/praisonai/praisonai/cli/commands/test.py">--help</a></code>
 * <code title="cli">praisonai test run <a href="./src/praisonai/praisonai/cli/commands/test.py">--help</a></code>
 * <code title="cli">praisonai todo add <a href="./src/praisonai/praisonai/cli/commands/todo.py">--help</a></code>
 * <code title="cli">praisonai todo done <a href="./src/praisonai/praisonai/cli/commands/todo.py">--help</a></code>

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>=3.7.2" \
+    "praisonai>=3.9.6" \
     "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>=3.7.2" \
+    "praisonai>=3.9.6" \
     "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>=3.7.2" \
+    "praisonai>=3.9.6" \
     "praisonai[ui]" \
     "praisonai[crewai]"
 

examples/benchmark/benchmark_example.py

@@ -35,7 +35,7 @@ def run_quick_comparison():
         prompt="What is 2+2?",
         iterations=2,
         paths=["openai_sdk", "praisonai_agent"],
-        verbose=True
+        output="verbose"
     )
     
     # Print comparison table
@@ -56,7 +56,7 @@ def run_full_benchmark():
     report = handler.run_full_benchmark(
         prompt="Hi",
         iterations=3,
-        verbose=True
+        output="verbose"
     )
     
     # Print full report
@@ -78,7 +78,7 @@ def run_agent_benchmark():
         prompt="Explain Python in one sentence",
         iterations=3,
         paths=["openai_sdk", "praisonai_agent"],
-        verbose=True
+        output="verbose"
     )
     
     # Show timeline diagrams

examples/compare/cli_compare_advanced.py

@@ -22,7 +22,7 @@ custom_modes = {
 }
 
 # Create handler with verbose output
-handler = CompareHandler(verbose=True)
+handler = CompareHandler(output="verbose")
 
 # Example: Manually create comparison results for analysis
 # (useful for testing without API calls)

examples/compare/cli_compare_basic.py

@@ -22,7 +22,7 @@ modes = parse_modes("basic,tools,planning")
 print(f"\nParsed modes: {modes}")
 
 # Create compare handler
-handler = CompareHandler(verbose=True)
+handler = CompareHandler(output="verbose")
 
 # Compare modes (this will run actual agent calls)
 # Uncomment to run:

examples/consolidated_params/advanced_workflow_full_features.py

@@ -32,7 +32,7 @@ workflow = Workflow(
         ),
     ],
     # Workflow-level consolidated params
-    output=WorkflowOutputConfig(verbose=True, stream=True),
+    output=WorkflowOutputConfig(output="verbose", stream=True),
     planning=WorkflowPlanningConfig(enabled=True, reasoning=True),
     memory=WorkflowMemoryConfig(backend="file"),
     # Agent-like params

examples/context/04_agent_integration.py

@@ -37,7 +37,7 @@ def main():
         name="CodeAssistant",
         instructions="You are a helpful code assistant.",
         context=config,
-        verbose=False
+        output="silent"
     )
     
     print(f"   Agent name: {agent.name}")

examples/cookbooks/yaml/secondary_market_research_agents.yaml

@@ -22,7 +22,7 @@ agents:  # Canonical: use 'agents' instead of 'roles'
     verbose: true
     allow_delegation: false
     llm:
-      model: "gpt-5-nano"
+      model: "gpt-4o-mini"
       temperature: 0.3
     tools:
       - "InternetSearchTool"
@@ -76,7 +76,7 @@ agents:  # Canonical: use 'agents' instead of 'roles'
     verbose: true
     allow_delegation: false
     llm:
-      model: "gpt-5-nano" 
+      model: "gpt-4o-mini" 
       temperature: 0.3
     tools:
       - "InternetSearchTool"
@@ -130,7 +130,7 @@ agents:  # Canonical: use 'agents' instead of 'roles'
     verbose: true
     allow_delegation: false
     llm:
-      model: "gpt-5-nano"
+      model: "gpt-4o-mini"
       temperature: 0.3
     tools:
       - "InternetSearchTool"
@@ -185,7 +185,7 @@ agents:  # Canonical: use 'agents' instead of 'roles'
     verbose: true
     allow_delegation: false
     llm:
-      model: "gpt-5-nano"
+      model: "gpt-4o-mini"
       temperature: 0.4
     tools:
       - "InternetSearchTool"
@@ -239,7 +239,7 @@ agents:  # Canonical: use 'agents' instead of 'roles'
     verbose: true
     allow_delegation: false
     llm:
-      model: "gpt-5-nano"
+      model: "gpt-4o-mini"
       temperature: 0.3
     tools:
       - "InternetSearchTool"
@@ -299,7 +299,7 @@ agents:  # Canonical: use 'agents' instead of 'roles'
     verbose: true
     allow_delegation: false
     llm:
-      model: "gpt-5-nano"
+      model: "gpt-4o-mini"
       temperature: 0.3
     tasks:
       report_synthesis:

examples/interactive_defaults/interactive_tools_example.py

@@ -105,7 +105,7 @@ def example_agent_with_default_tools():
         name="InteractiveAgent",
         instructions="You are a helpful coding assistant with file and code analysis capabilities.",
         tools=tools,
-        verbose=False
+        output="silent"
     )
     
     print(f"Agent created with {len(tools)} tools")

examples/knowledge/context_required_example.py

@@ -68,7 +68,7 @@ Answer questions based ONLY on the provided knowledge context.
 If the answer is not in the context, say 'I don't have that information.'
 Be precise and quote exact values when asked about codes or numbers.""",
             knowledge=[temp_dir],
-            user_id="demo_user",
+            memory={"user_id": "demo_user"},
             output="verbose",
         )
         

examples/knowledge/scope_isolation_example.py

@@ -50,7 +50,7 @@ Only authorized personnel with code WRENCH-992 may access this project.
             instructions="You ingest and store knowledge.",
             knowledge=[temp_dir],
             user_id="user_alice",  # Scoped to Alice
-            verbose=False,
+            output="silent",
         )
         
         # Ensure knowledge is processed
@@ -104,7 +104,7 @@ Only authorized personnel with code WRENCH-992 may access this project.
             instructions="Answer questions based on the provided knowledge. If you don't have the information, say so.",
             knowledge=[temp_dir],
             user_id="user_alice",  # Same scope as Agent A
-            verbose=False,
+            output="silent",
         )
         
         response = agent_b.chat("What is the secret access code for Project PHOENIX?")

examples/mcp/multi_server.py

@@ -0,0 +1,148 @@
+"""
+Multi-Server MCP Example.
+
+This example demonstrates how to use multiple MCP servers with PraisonAI Agents,
+including mixing MCP tools with regular Python function tools.
+
+Requirements:
+    - Node.js and npx installed (or uvx for Python-based servers)
+    - pip install praisonaiagents[mcp]
+    - OPENAI_API_KEY environment variable set
+
+Usage:
+    python multi_server.py
+"""
+
+from praisonaiagents import Agent, MCP
+import os
+
+
+def calculate(expression: str) -> str:
+    """
+    A simple calculator tool that evaluates mathematical expressions.
+    
+    Args:
+        expression: A mathematical expression to evaluate (e.g., "2 + 2")
+    
+    Returns:
+        The result of the calculation
+    """
+    try:
+        # Safe evaluation of mathematical expressions
+        allowed_chars = set("0123456789+-*/.() ")
+        if not all(c in allowed_chars for c in expression):
+            return "Error: Invalid characters in expression"
+        result = eval(expression)
+        return f"Result: {result}"
+    except Exception as e:
+        return f"Error: {str(e)}"
+
+
+def main():
+    # Check for API key
+    if not os.environ.get("OPENAI_API_KEY"):
+        print("Please set OPENAI_API_KEY environment variable")
+        return
+    
+    print("=" * 60)
+    print("Multi-Server MCP Example")
+    print("=" * 60)
+    
+    # Create MCP instance with Time server
+    print("\nInitializing MCP servers...")
+    try:
+        time_mcp = MCP("uvx mcp-server-time", timeout=30)
+        print("✓ Time MCP server initialized")
+    except Exception as e:
+        print(f"✗ Time MCP server failed: {e}")
+        return
+    
+    # Create an agent with multiple tool sources
+    agent = Agent(
+        name="MultiToolAgent",
+        instructions="""You are a helpful assistant with access to multiple tools:
+        1. Time tools - for getting current time in different timezones
+        2. Calculator - for mathematical calculations
+        
+        Use the appropriate tool based on the user's request.""",
+        llm="openai/gpt-4o-mini",
+        tools=[time_mcp, calculate]  # Mix MCP and regular tools
+    )
+    
+    # Show available tools
+    print("\nAvailable tools:")
+    formatted_tools = agent._format_tools_for_completion(agent.tools)
+    for tool in formatted_tools:
+        print(f"  - {tool['function']['name']}: {tool['function']['description'][:50]}...")
+    
+    # Example queries
+    queries = [
+        "What time is it in Tokyo?",
+        "Calculate 15 * 7 + 23",
+        "What's the current time in New York and London?"
+    ]
+    
+    print("\n" + "=" * 60)
+    print("Running queries...")
+    print("=" * 60)
+    
+    for i, query in enumerate(queries, 1):
+        print(f"\n--- Query {i} ---")
+        print(f"Question: {query}\n")
+        
+        try:
+            response = agent.chat(query)
+            print(f"Response:\n{response}")
+        except Exception as e:
+            print(f"Error: {e}")
+        
+        print("-" * 40)
+    
+    # Clean up
+    time_mcp.shutdown()
+    print("\nDone!")
+
+
+def demo_multiple_mcp_servers():
+    """
+    Demonstrate using multiple MCP servers simultaneously.
+    
+    This function shows how to create agents with multiple MCP servers,
+    each providing different capabilities.
+    """
+    print("\n" + "=" * 60)
+    print("Multiple MCP Servers Demo")
+    print("=" * 60)
+    
+    # Initialize multiple MCP servers
+    servers = {}
+    
+    try:
+        servers['time'] = MCP("uvx mcp-server-time", timeout=30)
+        print("✓ Time server initialized")
+    except Exception as e:
+        print(f"✗ Time server failed: {e}")
+    
+    # Create agent with all available servers
+    available_tools = list(servers.values())
+    
+    if not available_tools:
+        print("No MCP servers available")
+        return
+    
+    agent = Agent(
+        name="MultiServerAgent",
+        instructions="You have access to multiple MCP servers. Use the appropriate tools.",
+        llm="openai/gpt-4o-mini",
+        tools=available_tools
+    )
+    
+    print(f"\nAgent created with {len(available_tools)} MCP server(s)")
+    
+    # Clean up
+    for server in servers.values():
+        server.shutdown()
+
+
+if __name__ == "__main__":
+    main()

examples/mcp/sequential_thinking.py

@@ -0,0 +1,70 @@
+"""
+Sequential Thinking MCP Example.
+
+This example demonstrates how to use the Sequential Thinking MCP server
+with PraisonAI Agents to break down complex problems step by step.
+
+Requirements:
+    - Node.js and npx installed
+    - pip install praisonaiagents[mcp]
+    - OPENAI_API_KEY environment variable set
+
+Usage:
+    python sequential_thinking.py
+"""
+
+from praisonaiagents import Agent, MCP
+import os
+
+
+def main():
+    # Check for API key
+    if not os.environ.get("OPENAI_API_KEY"):
+        print("Please set OPENAI_API_KEY environment variable")
+        return
+    
+    # Create MCP instance with Sequential Thinking server
+    # The server provides tools for step-by-step problem analysis
+    sequential_mcp = MCP(
+        "npx -y @modelcontextprotocol/server-sequential-thinking",
+        timeout=60
+    )
+    
+    # Create an agent with the Sequential Thinking tools
+    agent = Agent(
+        name="ProblemSolver",
+        instructions="""You are an expert problem solver who breaks down complex problems 
+        into manageable steps. When given a problem:
+        1. Use the sequential thinking tool to analyze it step by step
+        2. Provide clear, actionable steps
+        3. Explain your reasoning at each step""",
+        llm="openai/gpt-4o-mini",
+        tools=sequential_mcp
+    )
+    
+    # Example problems to solve
+    problems = [
+        "Break down the process of making a cup of tea",
+        "How would you plan a weekend trip to a new city?",
+        "What steps would you take to learn a new programming language?"
+    ]
+    
+    print("=" * 60)
+    print("Sequential Thinking MCP Example")
+    print("=" * 60)
+    
+    for i, problem in enumerate(problems, 1):
+        print(f"\n--- Problem {i} ---")
+        print(f"Question: {problem}\n")
+        
+        response = agent.chat(problem)
+        print(f"Response:\n{response}")
+        print("-" * 40)
+    
+    # Clean up
+    sequential_mcp.shutdown()
+    print("\nDone!")
+
+
+if __name__ == "__main__":
+    main()

examples/performance/thread_safety_example.py

@@ -74,7 +74,7 @@ def example_agent_locks():
     agent = Agent(
         name="LockTestAgent",
         instructions="Test agent",
-        verbose=False
+        output="silent"
     )
     
     # Check for locks
@@ -112,7 +112,7 @@ def example_concurrent_real_api():
         name="ConcurrentAgent",
         instructions="Reply with one word only.",
         llm="gpt-4o-mini",
-        verbose=False
+        output="silent"
     )
     
     results = []

examples/persistence/knowledge_qdrant.py

@@ -51,7 +51,7 @@ agent = Agent(
     name="KnowledgeAssistant",
     instructions="You are a helpful assistant with access to technical documentation.",
     knowledge=[doc_path],
-    knowledge_config={
+    knowledge={
         "vector_store": "qdrant",
         "url": "http://localhost:6333"
     }

examples/persistence/simple_db_agent.py

@@ -39,7 +39,7 @@ agent = Agent(
     instructions="You are a helpful assistant. Keep responses brief.",
     db=db_instance,
     session_id="demo-session-001",  # Same session_id = resume conversation
-    verbose=False
+    output="silent"
 )
 
 # Chat with persistence

examples/python/agents/MULTI_PROVIDER_README.md

@@ -46,7 +46,7 @@ agent = RouterAgent(
     name="Smart Assistant",
     role="Adaptive AI Assistant",
     goal="Complete tasks using the most appropriate model",
-    models=["gpt-5-nano", "gpt-5-nano", "claude-3-5-sonnet-20241022"],
+    models=["gpt-4o-mini", "gpt-4o-mini", "claude-3-5-sonnet-20241022"],
     routing_strategy="auto"  # Automatic model selection
 )
 
@@ -90,7 +90,7 @@ analyzer = RouterAgent(
     goal="Analyze data efficiently",
     models={
         "gemini/gemini-1.5-flash": {},
-        "gpt-5-nano": {},
+        "gpt-4o-mini": {},
         "claude-3-haiku-20240307": {}
     },
     model_router=router,
@@ -207,7 +207,7 @@ for i, agent in enumerate(auto.agents):
         name=agent.name,
         role=agent.role,
         goal=agent.goal,
-        models=["gpt-5-nano", "gpt-5-nano", "claude-3-5-sonnet"],
+        models=["gpt-4o-mini", "gpt-4o-mini", "claude-3-5-sonnet"],
         routing_strategy="auto"
     )
 

examples/python/cli/git_integration_example.py

@@ -8,7 +8,7 @@ Docs: https://docs.praison.ai/cli/git-integration
 from praisonai.cli.features import GitIntegrationHandler
 
 # Initialize
-handler = GitIntegrationHandler(verbose=True)
+handler = GitIntegrationHandler(output="verbose")
 git = handler.initialize(repo_path=".")
 
 # Check if it's a git repo

examples/python/cli/repo_map_example.py

@@ -8,7 +8,7 @@ Docs: https://docs.praison.ai/cli/repo-map
 from praisonai.cli.features import RepoMapHandler
 
 # Initialize with current directory
-handler = RepoMapHandler(verbose=True)
+handler = RepoMapHandler(output="verbose")
 repo_map = handler.initialize(root=".")
 
 # Get the repository map

examples/python/cli/sandbox_execution_example.py

@@ -9,7 +9,7 @@ from praisonai.cli.features import SandboxExecutorHandler
 from praisonai.cli.features.sandbox_executor import SandboxMode
 
 # Initialize with basic sandbox
-handler = SandboxExecutorHandler(verbose=True)
+handler = SandboxExecutorHandler(output="verbose")
 sandbox = handler.initialize(mode="basic")
 
 print(f"Sandbox mode: {handler.get_mode()}")

examples/python/concepts/chat-with-pdf.py

@@ -26,7 +26,7 @@ pdf_agent = Agent(
     backstory="You are an expert at reading, analyzing, and answering questions about PDF documents. You provide accurate, detailed answers based on the document content.",
     instructions="Read the provided PDF document and answer questions about its content. Be specific and cite relevant sections when possible.",
     knowledge=["document.pdf"],  # Replace with your PDF file path
-    knowledge_config=config,
+    knowledge=config,
     reflection=True,
     
     

examples/python/concepts/knowledge-agents-task.py

@@ -24,7 +24,7 @@ knowledge_agent = Agent(
     goal="Store and retrieve knowledge efficiently",
     backstory="Expert in managing and utilizing stored knowledge",
     knowledge=["sample.pdf"],
-    knowledge_config=config)
+    knowledge=config)
 
 # Define a task for the agent
 knowledge_task = Task(

examples/python/concepts/knowledge-agents.py

@@ -13,8 +13,7 @@ config = {
 agent = Agent(
     name="Knowledge Agent",
     instructions="You answer questions based on the provided knowledge.",
-    knowledge=["small.pdf"],
-    knowledge_config=config
+    knowledge=["small.pdf"]
 )
 
 agent.start("What is KAG in one line?")

examples/python/concepts/knowledge-reranker-example.py

@@ -139,7 +139,7 @@ def main():
         name="AI Research Assistant",
         instructions="You are an AI research assistant. Use your knowledge base to answer questions about artificial intelligence topics.",
         knowledge=sample_documents,  # Will use default knowledge config
-        knowledge_config=rerank_config,  # Use reranking config
+        knowledge=rerank_config,  # Use reranking config
         llm="gpt-4o-mini"
     )
     

examples/python/dict_config_example.py

@@ -16,7 +16,7 @@ def example_dict_output_config():
     """Example: Using dict for output configuration."""
     from praisonaiagents import Agent
     
-    # Dict shorthand - equivalent to OutputConfig(verbose=True, stream=False)
+    # Dict shorthand - equivalent to OutputConfig(output="verbose", stream=False)
     agent = Agent(
         name="Assistant",
         instructions="You are a helpful assistant.",

examples/python/general/memory_example.py

@@ -104,11 +104,13 @@ def main():
     agents = Agents(
         agents=[researcher, retriever],
         tasks=[store_task, verify_task, query_task, query_both_task],  # Use same verbose level as memory
-        memory=True,
-        embedder={
-            "provider": "openai",
-            "config": {
-                "model": "text-embedding-3-small"
+        memory={
+            "provider": "rag",
+            "embedder": {
+                "provider": "openai",
+                "config": {
+                    "model": "text-embedding-3-small"
+                }
             }
         }
     )

examples/python/memory/advanced-graph-memory-integration.py

@@ -61,7 +61,7 @@ agents_system = Agents(
     agents=[knowledge_agent],
     tasks=[build_task, query_task],
     memory=True,
-    memory_config=memory_config, output="verbose"
+    memory=memory_config, output="verbose"
 )
 
 print("Starting graph memory demonstration...")

examples/python/memory/advanced-memory-search-optimization.py

@@ -62,7 +62,7 @@ agents_system = Agents(
     agents=[research_agent],
     tasks=[build_memory_task, search_task],
     memory=True,
-    memory_config=memory_config, output="verbose"
+    memory=memory_config, output="verbose"
 )
 
 print("Starting memory search optimization demonstration...")

examples/python/memory/gemini-embedding-example.py

@@ -85,13 +85,13 @@ def main():
     agents = Agents(
         agents=[researcher, retriever],
         tasks=[store_task, retrieve_task],
-        memory=True,
-        embedder={
-            "provider": "gemini",
-            "config": {
-                "model": "text-embedding-004",
-                # Optional: specify task type for better results
-                # "task_type": "RETRIEVAL_DOCUMENT"  
+        memory={
+            "provider": "rag",
+            "embedder": {
+                "provider": "gemini",
+                "config": {
+                    "model": "text-embedding-004",
+                }
             }
         }
     )

examples/python/memory/gemini-embeddings.md

@@ -97,7 +97,7 @@ researcher = Agent(
     name="Researcher",
     role="Information Researcher",
     goal="Store information with semantic understanding",
-    llm="gpt-5-nano"
+    llm="gpt-4o-mini"
 )
 
 # Create task

examples/python/memory/graph-memory-agent.py

@@ -153,7 +153,7 @@ def main():
         agents=[researcher],
         tasks=[build_knowledge_task, query_knowledge_task, expand_knowledge_task],
         memory=True,
-        memory_config=memory_config
+        memory=memory_config
     )
     
     print("\n🚀 Starting graph memory demonstration...")

examples/python/models/deepseek/deepseek-rag-agents-streamlit.py

@@ -33,7 +33,7 @@ def init_agent():
         name="Knowledge Agent",
         instructions="You answer questions based on the provided knowledge.",
         knowledge=["kag-research-paper.pdf"],
-        knowledge_config=config,
+        knowledge=config,
         user_id="user1",
         llm="deepseek-r1"
     )

examples/python/models/deepseek/deepseek-rag-agents.py

@@ -31,7 +31,7 @@ agent = Agent(
     name="Knowledge Agent",
     instructions="You answer questions based on the provided knowledge.",
     knowledge=["kag-research-paper.pdf"], # Indexing
-    knowledge_config=config,
+    knowledge=config,
     user_id="user1",
     llm="deepseek-r1"
 )

examples/python/mongodb/mongodb_comprehensive_example.py

@@ -81,7 +81,7 @@ def main():
         backstory="""You are a knowledge management specialist who excels at 
         organizing, categorizing, and retrieving information from the knowledge base. 
         You ensure that knowledge is properly stored, indexed, and accessible.""",
-        knowledge_config=mongodb_knowledge_config,
+        knowledge=mongodb_knowledge_config,
         memory=True,
         llm="gpt-4o-mini"
     )
@@ -107,7 +107,7 @@ def main():
         backstory="""You are a customer service representative who uses the 
         knowledge base and customer data to provide excellent support. You can 
         access customer history, product information, and troubleshooting guides.""",
-        knowledge_config=mongodb_knowledge_config,
+        knowledge=mongodb_knowledge_config,
         tools=[mongodb_tools],
         memory=True,
         llm="gpt-4o-mini"
@@ -190,7 +190,7 @@ def main():
         agents=[data_manager, knowledge_curator, business_analyst, customer_service],
         tasks=business_tasks,
         memory=True,
-        memory_config=mongodb_memory_config, output="verbose"
+        memory=mongodb_memory_config, output="verbose"
     )
     
     # Execute the comprehensive business pipeline

examples/python/mongodb/mongodb_knowledge_example.py

@@ -55,7 +55,7 @@ def main():
         retrieve information from a comprehensive MongoDB knowledge base. You excel 
         at finding relevant information, synthesizing knowledge from multiple sources, 
         and providing accurate, context-aware responses.""",
-        knowledge_config=mongodb_knowledge_config,
+        knowledge=mongodb_knowledge_config,
         knowledge=[os.path.join(os.path.dirname(__file__), "llms.md")],
         memory=True,
         llm="gpt-4o-mini"

examples/python/mongodb/mongodb_memory_example.py

@@ -94,7 +94,7 @@ def main():
         agents=[research_agent],
         tasks=research_tasks,
         memory=True,
-        memory_config=mongodb_memory_config, output="verbose"
+        memory=mongodb_memory_config, output="verbose"
     )
     
     # Execute the research pipeline

examples/python/monitoring/README.md

@@ -17,7 +17,7 @@ def my_function():
 
 agent = Agent(
     instructions="You are a helpful assistant",
-    llm="gpt-5-nano"
+    llm="gpt-4o-mini"
 )
 
 with track_api_call("agent_request"):

examples/python/profiling/profile_results/suite_results.json

@@ -1,155 +1,155 @@
 {
-  "timestamp": "2025-12-31T18:45:38.187539Z",
+  "timestamp": "2026-01-16T05:23:04.919943Z",
   "metadata": {
     "python_version": "3.12.11",
-    "platform": "macOS-15.7.4-arm64-arm-64bit",
-    "praisonai_version": "2.9.2",
-    "timestamp": "2025-12-31T18:45:38.226558Z"
+    "platform": "macOS-26.3-arm64-arm-64bit",
+    "praisonai_version": "3.9.2",
+    "timestamp": "2026-01-16T05:23:04.932474Z"
   },
   "startup": {
-    "cold_ms": 80.9305000002496,
-    "warm_ms": 55.266541996388696
+    "cold_ms": 27.866583000104583,
+    "warm_ms": 27.75670800019725
   },
   "import_analysis": [
     {
       "module": "praisonaiagents",
-      "self_us": 2419,
-      "cumulative_us": 1645390,
-      "self_ms": 2.419,
-      "cumulative_ms": 1645.39
+      "self_us": 403,
+      "cumulative_us": 188329,
+      "self_ms": 0.403,
+      "cumulative_ms": 188.329
     },
     {
       "module": "praisonaiagents.workflows",
-      "self_us": 670,
-      "cumulative_us": 1375919,
-      "self_ms": 0.67,
-      "cumulative_ms": 1375.919
+      "self_us": 106,
+      "cumulative_us": 112180,
+      "self_ms": 0.106,
+      "cumulative_ms": 112.18
     },
     {
       "module": "praisonaiagents.workflows.yaml_parser",
-      "self_us": 775,
-      "cumulative_us": 1369435,
-      "self_ms": 0.775,
-      "cumulative_ms": 1369.435
+      "self_us": 217,
+      "cumulative_us": 107210,
+      "self_ms": 0.217,
+      "cumulative_ms": 107.21
     },
     {
       "module": "praisonaiagents.agent.agent",
-      "self_us": 19,
-      "cumulative_us": 1349174,
-      "self_ms": 0.019,
-      "cumulative_ms": 1349.174
+      "self_us": 15,
+      "cumulative_us": 98811,
+      "self_ms": 0.015,
+      "cumulative_ms": 98.811
     },
     {
       "module": "praisonaiagents.agent",
-      "self_us": 537,
-      "cumulative_us": 1349155,
-      "self_ms": 0.537,
-      "cumulative_ms": 1349.155
+      "self_us": 146,
+      "cumulative_us": 98796,
+      "self_ms": 0.146,
+      "cumulative_ms": 98.796
     },
     {
       "module": "praisonaiagents.agent.agent",
-      "self_us": 1453,
-      "cumulative_us": 1285299,
-      "self_ms": 1.453,
-      "cumulative_ms": 1285.299
-    },
-    {
-      "module": "praisonaiagents.llm.openai_client",
-      "self_us": 7887,
-      "cumulative_us": 1123578,
-      "self_ms": 7.887,
-      "cumulative_ms": 1123.578
-    },
-    {
-      "module": "openai",
-      "self_us": 1083,
-      "cumulative_us": 1115692,
-      "self_ms": 1.083,
-      "cumulative_ms": 1115.692
-    },
-    {
-      "module": "openai.types",
-      "self_us": 2606,
-      "cumulative_us": 957990,
-      "self_ms": 2.606,
-      "cumulative_ms": 957.99
-    },
-    {
-      "module": "openai.types.batch",
-      "self_us": 1787,
-      "cumulative_us": 485667,
-      "self_ms": 1.787,
-      "cumulative_ms": 485.667
-    },
-    {
-      "module": "openai._models",
-      "self_us": 13423,
-      "cumulative_us": 450798,
-      "self_ms": 13.423,
-      "cumulative_ms": 450.798
-    },
-    {
-      "module": "openai.types.eval_create_params",
-      "self_us": 644,
-      "cumulative_us": 393275,
-      "self_ms": 0.644,
-      "cumulative_ms": 393.275
-    },
-    {
-      "module": "openai.types.graders.grader_inputs_param",
-      "self_us": 17,
-      "cumulative_us": 359515,
-      "self_ms": 0.017,
-      "cumulative_ms": 359.515
-    },
-    {
-      "module": "openai.types.graders",
-      "self_us": 392,
-      "cumulative_us": 359498,
-      "self_ms": 0.392,
-      "cumulative_ms": 359.498
-    },
-    {
-      "module": "openai.types.graders.multi_grader",
-      "self_us": 3847,
-      "cumulative_us": 351251,
-      "self_ms": 3.847,
-      "cumulative_ms": 351.251
-    },
-    {
-      "module": "openai.types.graders.label_model_grader",
-      "self_us": 5450,
-      "cumulative_us": 337291,
-      "self_ms": 5.45,
-      "cumulative_ms": 337.291
-    },
-    {
-      "module": "openai.types.graders.grader_inputs",
-      "self_us": 545,
-      "cumulative_us": 331841,
-      "self_ms": 0.545,
-      "cumulative_ms": 331.841
-    },
-    {
-      "module": "openai.types.responses.response_input_text",
-      "self_us": 21,
-      "cumulative_us": 331297,
-      "self_ms": 0.021,
-      "cumulative_ms": 331.297
-    },
-    {
-      "module": "openai.types.responses",
-      "self_us": 1301,
-      "cumulative_us": 331277,
-      "self_ms": 1.301,
-      "cumulative_ms": 331.277
+      "self_us": 1027,
+      "cumulative_us": 86223,
+      "self_ms": 1.027,
+      "cumulative_ms": 86.223
     },
     {
       "module": "rich.logging",
-      "self_us": 1066,
-      "cumulative_us": 238256,
-      "self_ms": 1.066,
-      "cumulative_ms": 238.256
+      "self_us": 282,
+      "cumulative_us": 53009,
+      "self_ms": 0.282,
+      "cumulative_ms": 53.009
+    },
+    {
+      "module": "praisonaiagents.main",
+      "self_us": 18784,
+      "cumulative_us": 45759,
+      "self_ms": 18.784,
+      "cumulative_ms": 45.759
+    },
+    {
+      "module": "praisonaiagents.llm.openai_client",
+      "self_us": 2470,
+      "cumulative_us": 28251,
+      "self_ms": 2.47,
+      "cumulative_ms": 28.251
+    },
+    {
+      "module": "rich.traceback",
+      "self_us": 1478,
+      "cumulative_us": 18788,
+      "self_ms": 1.478,
+      "cumulative_ms": 18.788
+    },
+    {
+      "module": "rich.console",
+      "self_us": 1737,
+      "cumulative_us": 18587,
+      "self_ms": 1.737,
+      "cumulative_ms": 18.587
+    },
+    {
+      "module": "pygments.lexers",
+      "self_us": 242,
+      "cumulative_us": 15427,
+      "self_ms": 0.242,
+      "cumulative_ms": 15.427
+    },
+    {
+      "module": "rich.markdown",
+      "self_us": 409,
+      "cumulative_us": 13987,
+      "self_ms": 0.409,
+      "cumulative_ms": 13.987
+    },
+    {
+      "module": "pygments.plugin",
+      "self_us": 85,
+      "cumulative_us": 13503,
+      "self_ms": 0.085,
+      "cumulative_ms": 13.503
+    },
+    {
+      "module": "importlib.metadata",
+      "self_us": 637,
+      "cumulative_us": 13419,
+      "self_ms": 0.637,
+      "cumulative_ms": 13.419
+    },
+    {
+      "module": "rich._log_render",
+      "self_us": 145,
+      "cumulative_us": 13380,
+      "self_ms": 0.145,
+      "cumulative_ms": 13.38
+    },
+    {
+      "module": "markdown_it",
+      "self_us": 172,
+      "cumulative_us": 13339,
+      "self_ms": 0.172,
+      "cumulative_ms": 13.339
+    },
+    {
+      "module": "rich.text",
+      "self_us": 582,
+      "cumulative_us": 13236,
+      "self_ms": 0.582,
+      "cumulative_ms": 13.236
+    },
+    {
+      "module": "markdown_it.main",
+      "self_us": 298,
+      "cumulative_us": 13168,
+      "self_ms": 0.298,
+      "cumulative_ms": 13.168
+    },
+    {
+      "module": "pydantic",
+      "self_us": 223,
+      "cumulative_us": 11119,
+      "self_ms": 0.223,
+      "cumulative_ms": 11.119
     }
   ],
   "scenarios": [
@@ -162,28 +162,22 @@
         "iterations": 2
       },
       "import_time_stats": {
-        "mean": 0.008833496394800022,
-        "min": 0.005916997906751931,
-        "max": 0.011749994882848114,
-        "stdev": 0.0041245517164382375,
-        "median": 0.008833496394800022
+        "mean": 0,
+        "min": 0,
+        "max": 0,
+        "stdev": 0,
+        "median": 0
       },
       "total_time_stats": {
-        "mean": 1727.4090415012324,
-        "min": 1367.2264170018025,
-        "max": 2087.5916660006624,
-        "stdev": 509.3751524982296,
-        "median": 1727.4090415012324
+        "mean": 0,
+        "min": 0,
+        "max": 0,
+        "stdev": 0,
+        "median": 0
       },
       "first_token_stats": null,
-      "raw_import_times_ms": [
-        0.011749994882848114,
-        0.005916997906751931
-      ],
-      "raw_total_times_ms": [
-        1367.2264170018025,
-        2087.5916660006624
-      ]
+      "raw_import_times_ms": [],
+      "raw_total_times_ms": []
     },
     {
       "name": "simple_stream",
@@ -194,34 +188,22 @@
         "iterations": 2
       },
       "import_time_stats": {
-        "mean": 0.008792001608526334,
-        "min": 0.006375004886649549,
-        "max": 0.01120899833040312,
-        "stdev": 0.0034181495442894613,
-        "median": 0.008792001608526334
+        "mean": 0,
+        "min": 0,
+        "max": 0,
+        "stdev": 0,
+        "median": 0
       },
       "total_time_stats": {
-        "mean": 2321.0982290001994,
-        "min": 1697.1089580038097,
-        "max": 2945.087499996589,
-        "stdev": 882.4540898183949,
-        "median": 2321.0982290001994
+        "mean": 0,
+        "min": 0,
+        "max": 0,
+        "stdev": 0,
+        "median": 0
       },
-      "first_token_stats": {
-        "mean": 2312.8511880022415,
-        "min": 1681.2440420035273,
-        "max": 2944.458334000956,
-        "stdev": 893.2273919631452,
-        "median": 2312.8511880022415
-      },
-      "raw_import_times_ms": [
-        0.01120899833040312,
-        0.006375004886649549
-      ],
-      "raw_total_times_ms": [
-        2945.087499996589,
-        1697.1089580038097
-      ]
+      "first_token_stats": null,
+      "raw_import_times_ms": [],
+      "raw_total_times_ms": []
     }
   ]
 }

examples/python/token-metrics/README.md

@@ -13,7 +13,7 @@ agent = Agent(
     role="Assistant", 
     goal="Help users",
     backstory="You are helpful.",
-    llm="gpt-5-nano",
+    llm="gpt-4o-mini",
     metrics=True  # 🎯 That's it!
 )
 

examples/python/ui/mcp-streamlit-simple.py

@@ -50,5 +50,5 @@ with st.expander("🔧 Troubleshooting"):
     **If you still have issues:**
     - Make sure you have Node.js installed for the MCP server
     - Set your OpenAI API key: `export OPENAI_API_KEY="your-key"`
-    - Try the debug mode by setting `verbose=True`
+    - Try the debug mode by setting `output="verbose"`
     """)

examples/python/ui/ollama-rag-agents-streamlit.py

@@ -33,7 +33,7 @@ def init_agent():
         name="Knowledge Agent",
         instructions="You answer questions based on the provided knowledge.",
         knowledge=["kag-research-paper.pdf"],
-        knowledge_config=config,
+        knowledge=config,
         user_id="user1",
         llm="deepseek-r1"
     )

examples/python/usecases/README-secondary-market-research.md

@@ -177,7 +177,7 @@ Set your API keys:
 
 ```bash
 export OPENAI_API_KEY="your-api-key"
-export OPENAI_MODEL_NAME="gpt-5-nano"
+export OPENAI_MODEL_NAME="gpt-4o-mini"
 ```
 
 ## 📝 Customization

examples/python/usecases/domain-context-solution.py

@@ -265,7 +265,7 @@ agents = Agents(
     process="hierarchical",
     manager_llm="gpt-4o-mini",
     memory=True,  # Enable shared memory for domain context
-    memory_config={
+    memory={
         "provider": "rag",
         "config": {
             "collection_name": f"{domain.replace('.', '_')}_security_analysis"

examples/rag/auto_retrieval.py

@@ -58,7 +58,7 @@ def auto_rag_basic():
         
         KNOWLEDGE BASE:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     # Wrap with AutoRagAgent for intelligent retrieval
@@ -105,7 +105,7 @@ def auto_rag_with_policies():
         
         KNOWLEDGE BASE:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     print("\n" + "=" * 60)
@@ -153,7 +153,7 @@ def auto_rag_config_options():
         
         KNOWLEDGE BASE:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     print("\n" + "=" * 60)

examples/rag/basic_retrieval.py

@@ -79,7 +79,7 @@ def rag_with_query_context():
     agent = Agent(
         name="Research Assistant",
         instructions="You answer questions based on the context provided in each query.",
-        verbose=False
+        output="silent"
     )
     
     # Simulate retrieved context (in real RAG, this comes from vector search)

examples/rag/chunking_strategies.py

@@ -204,7 +204,7 @@ def rag_with_section_chunks():
         
         PRODUCT DOCUMENTATION:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     queries = [

examples/rag/citations.py

@@ -103,7 +103,7 @@ def basic_citations():
         
         POLICY DOCUMENTS:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     queries = [
@@ -146,7 +146,7 @@ def structured_citations():
         
         POLICY DOCUMENTS:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     query = "What are the requirements for remote work eligibility?"
@@ -183,7 +183,7 @@ def inline_citations():
         
         POLICY DOCUMENTS:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     query = "Summarize the key employee benefits."
@@ -267,7 +267,7 @@ def multi_source_synthesis():
         
         POLICY DOCUMENTS:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     query = "Give me a complete overview of employee benefits and policies."

examples/rag/external_sources.py

@@ -125,7 +125,7 @@ def web_augmented_rag():
         
         COMPANY KNOWLEDGE:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     # Simulate web-augmented queries
@@ -171,7 +171,7 @@ def database_augmented_rag():
         
         COMPANY KNOWLEDGE:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     queries = [
@@ -249,7 +249,7 @@ def hybrid_source_rag():
         
         COMPANY KNOWLEDGE:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     query = "Give me a complete business briefing for today"

examples/rag/hybrid_search.py

@@ -156,7 +156,7 @@ def hybrid_rag_example():
         
         TROUBLESHOOTING KNOWLEDGE BASE:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     # Test with different query types
@@ -204,7 +204,7 @@ def compare_retrieval_modes():
         
         KNOWLEDGE BASE:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     print(f"\n📝 Query: {query}")

examples/rag/knowledge_graph.py

@@ -124,7 +124,7 @@ def graph_aware_rag():
         
         KNOWLEDGE GRAPH:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     # Relationship-focused queries
@@ -167,7 +167,7 @@ def multi_hop_reasoning():
         
         KNOWLEDGE GRAPH:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     # Multi-hop query requiring traversal
@@ -200,7 +200,7 @@ def entity_type_filtering():
         
         SCIENTISTS:
         {people_context}""",
-        verbose=False
+        output="silent"
     )
     
     # Filter to only concepts
@@ -213,7 +213,7 @@ def entity_type_filtering():
         
         CONCEPTS:
         {concepts_context}""",
-        verbose=False
+        output="silent"
     )
     
     query = "Tell me about the major developments in early 20th century physics."

examples/rag/multi_document.py

@@ -112,7 +112,7 @@ def multi_document_rag():
         
         REPORTS:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     # Questions that require multi-document synthesis
@@ -157,7 +157,7 @@ def cross_reference_example():
         
         REPORTS:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     query = """
@@ -185,7 +185,7 @@ def document_filtering():
         
         POLICY REPORT:
         {POLICY_REPORT['content']}""",
-        verbose=False
+        output="silent"
     )
     
     tech_agent = Agent(
@@ -194,7 +194,7 @@ def document_filtering():
         
         TECHNOLOGY REPORT:
         {TECH_REPORT['content']}""",
-        verbose=False
+        output="silent"
     )
     
     query = "What progress has been made in addressing climate change?"

examples/rag/rag_evaluation.py

@@ -124,7 +124,7 @@ def main():
         
         KNOWLEDGE:
         {SAMPLE_KNOWLEDGE}""",
-        verbose=False
+        output="silent"
     )
     
     # Get test queries

examples/rag/rag_multi_agent.py

@@ -61,7 +61,7 @@ def main():
         
         KNOWLEDGE BASE:
         {SHARED_KNOWLEDGE}""",
-        verbose=False
+        output="silent"
     )
     
     summarizer = Agent(
@@ -75,7 +75,7 @@ def main():
         
         KNOWLEDGE BASE:
         {SHARED_KNOWLEDGE}""",
-        verbose=False
+        output="silent"
     )
     
     writer = Agent(
@@ -89,7 +89,7 @@ def main():
         
         KNOWLEDGE BASE:
         {SHARED_KNOWLEDGE}""",
-        verbose=False
+        output="silent"
     )
     
     # Define tasks
@@ -118,7 +118,7 @@ def main():
         agents=[researcher, summarizer, writer],
         tasks=[research_task, summary_task, report_task],
         process="sequential",
-        verbose=False
+        output="silent"
     )
     
     result = agents.start()

examples/rag/rag_pdf_qa.py

@@ -67,7 +67,7 @@ def main():
         
         DOCUMENT:
         {DOCUMENT_CONTENT}""",
-        verbose=False
+        output="silent"
     )
     
     query = "What are the main topics covered in this document?"
@@ -88,7 +88,7 @@ def main():
         
         DOCUMENT:
         {DOCUMENT_CONTENT}""",
-        verbose=False
+        output="silent"
     )
     
     queries = [
@@ -114,7 +114,7 @@ def main():
         
         DOCUMENT:
         {DOCUMENT_CONTENT}""",
-        verbose=False
+        output="silent"
     )
     
     analysis_query = "Compare the benefits vs challenges of remote work based on this study"

examples/rag/reranking.py

@@ -131,7 +131,7 @@ def rag_with_reranking():
         
         RESEARCH PAPERS:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     queries = [
@@ -170,7 +170,7 @@ def compare_with_without_reranking():
         
         RESEARCH PAPERS:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     print(f"\n📝 Query: {query}")
@@ -196,7 +196,7 @@ def reranking_configuration():
     agent = Agent(
         name="My Agent",
         knowledge=documents,
-        knowledge_config={
+        knowledge={
             # Enable reranking
             "rerank": True,
             

examples/rag/retrieval_policies.py

@@ -134,7 +134,7 @@ def policy_based_retrieval():
         
         IT SUPPORT DOCS:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     query = "How do I set up VPN?"
@@ -217,7 +217,7 @@ def priority_based_retrieval():
         
         HIGH PRIORITY DOCS:
         {high_context}""",
-        verbose=False
+        output="silent"
     )
     
     # Full knowledge agent
@@ -227,7 +227,7 @@ def priority_based_retrieval():
         
         IT SUPPORT DOCS:
         {full_context}""",
-        verbose=False
+        output="silent"
     )
     
     query = "I'm locked out of my account!"

examples/rag/structured_output.py

@@ -110,7 +110,7 @@ def json_output_rag():
         
         PRODUCT CATALOG:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     # Request structured product info
@@ -154,7 +154,7 @@ def pydantic_guided_rag():
         
         PRODUCT CATALOG:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     query = "Compare the UltraWidget Pro and SmartHome Hub. Which should I buy?"
@@ -184,7 +184,7 @@ def table_format_rag():
         
         PRODUCT CATALOG:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     query = "Show me all products in a table with name, price, and rating."
@@ -212,7 +212,7 @@ def list_format_rag():
         
         PRODUCT CATALOG:
         {context}""",
-        verbose=False
+        output="silent"
     )
     
     queries = [
@@ -321,7 +321,7 @@ def multi_format_rag():
             
             PRODUCT CATALOG:
             {context}""",
-            verbose=False
+            output="silent"
         )
         
         response = agent.chat(query)

examples/vector/chroma_wow.py

@@ -6,7 +6,7 @@ agent = Agent(
     name="Assistant",
     instructions="You are a helpful assistant with access to documents.",
     knowledge=["./docs/guide.pdf"],  # Add your documents here
-    knowledge_config={
+    knowledge={
         "vector_store": "chroma",
         "path": "/tmp/chroma_demo"
     }

examples/vector/lancedb_real_wow.py

@@ -6,7 +6,7 @@ agent = Agent(
     name="Assistant",
     instructions="You are a helpful assistant with access to documents.",
     knowledge=["./docs/guide.pdf"],  # Add your documents here
-    knowledge_config={
+    knowledge={
         "vector_store": "lancedb",
         "path": "/tmp/lancedb_test"
     }

examples/vector/lancedb_wow.py

@@ -6,7 +6,7 @@ agent = Agent(
     name="Assistant",
     instructions="You are a helpful assistant with access to documents.",
     knowledge=["./docs/guide.pdf"],  # Add your documents here
-    knowledge_config={
+    knowledge={
         "vector_store": "lancedb",
         "path": "/tmp/lancedb_demo"
     }

examples/vector/pgvector_real_wow.py

@@ -12,7 +12,7 @@ agent = Agent(
     name="Assistant",
     instructions="You are a helpful assistant with access to documents.",
     knowledge=["./docs/guide.pdf"],  # Add your documents here
-    knowledge_config={
+    knowledge={
         "vector_store": "pgvector",
         "url": url
     }

examples/vector/pgvector_wow.py

@@ -12,7 +12,7 @@ agent = Agent(
     name="Assistant",
     instructions="You are a helpful assistant with access to documents.",
     knowledge=["./docs/guide.pdf"],  # Add your documents here
-    knowledge_config={
+    knowledge={
         "vector_store": "pgvector",
         "url": url
     }

examples/vector/pinecone_wow.py

@@ -16,7 +16,7 @@ agent = Agent(
     name="Assistant",
     instructions="You are a helpful assistant with access to documents.",
     knowledge=["./docs/guide.pdf"],  # Add your documents here
-    knowledge_config={
+    knowledge={
         "vector_store": "pinecone",
         "api_key": api_key,
         "environment": "us-east-1"

examples/vector/qdrant_wow.py

@@ -12,7 +12,7 @@ agent = Agent(
     name="Assistant",
     instructions="You are a helpful assistant with access to documents.",
     knowledge=["./docs/guide.pdf"],  # Add your documents here
-    knowledge_config={
+    knowledge={
         "vector_store": "qdrant",
         "url": url
     }

examples/vector/weaviate_wow.py

@@ -17,7 +17,7 @@ agent = Agent(
     name="Assistant",
     instructions="You are a helpful assistant with access to documents.",
     knowledge=["./docs/guide.pdf"],  # Add your documents here
-    knowledge_config={
+    knowledge={
         "vector_store": "weaviate",
         "url": weaviate_url,
         "api_key": weaviate_key

examples/yaml/workflows/example_usage.py

@@ -93,7 +93,7 @@ def example_3_execute_yaml_directly():
     result = manager.execute_yaml(
         yaml_file,
         input_data="The future of AI",
-        verbose=True
+        output="verbose"
     )
     
     print(f"Status: {result['status']}")

src/praisonai-agents/01_basic_agent_with_monitoring.py

@@ -38,7 +38,7 @@ def main():
     # Create agent
     agent = Agent(
         instructions="You are a helpful assistant that explains scientific concepts simply",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     # Track the API call performance

src/praisonai-agents/01_basic_token_tracking.py

@@ -7,15 +7,14 @@ will be automatically displayed when tasks complete!
 from praisonaiagents import Agents, Agent, Task
 
 def main():
-    # Create a simple agent with metrics=True - that's it!
+    # Create a simple agent with output="debug" - includes metrics!
     research_agent = Agent(
         name="Research Agent",
         role="Research Specialist", 
         goal="Find information about a topic",
         backstory="You are an expert researcher who finds comprehensive information.",
-        verbose=True,
-        llm="gpt-5-nano",  # Use a cost-effective model for examples
-        metrics=True  # 🎯 SIMPLIFIED: Just add this parameter!
+        output="debug",  # 🎯 SIMPLIFIED: debug preset includes metrics!
+        llm="gpt-4o-mini",  # Use a cost-effective model for examples
     )
     
     # Create a simple task
@@ -29,7 +28,7 @@ def main():
     agents = Agents(
         agents=[research_agent],
         tasks=[research_task],
-        verbose=True
+        output="verbose"
     )
     
     print("🚀 Running agent task...")

src/praisonai-agents/02_multi_agent_workflow_monitoring.py

@@ -54,7 +54,7 @@ def create_agents():
         goal="Gather comprehensive information on renewable energy",
         backstory="Expert researcher with deep knowledge of energy sector",
         instructions="You are a thorough researcher. Provide detailed, fact-based information.",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     analyst = Agent(
@@ -63,7 +63,7 @@ def create_agents():
         goal="Analyze trends and patterns in renewable energy data",
         backstory="Experienced data analyst specializing in energy markets",
         instructions="You are an analytical thinker. Focus on trends, patterns, and insights.",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     writer = Agent(
@@ -72,7 +72,7 @@ def create_agents():
         goal="Create clear, compelling reports",
         backstory="Professional technical writer with expertise in energy sector",
         instructions="You are a skilled writer. Create clear, well-structured reports.",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     return researcher, analyst, writer
@@ -104,8 +104,7 @@ def main():
         workflow = Agents(
             agents=[researcher, analyst, writer],
             tasks=[research_task, analysis_task, report_task], 
-            process="sequential",
-            verbose=True
+            process="sequential"
         )
         
         result = workflow.start()

src/praisonai-agents/03_agent_with_tools_monitoring.py

@@ -11,7 +11,7 @@ Shows how to monitor agent performance when using external tools.
 """
 
 from praisonaiagents import Agent
-from praisonaiagents.tools import duckduckgo, wikipedia
+from praisonaiagents.tools import duckduckgo, wikipedia_tools
 from praisonaiagents.telemetry import (
     monitor_function, track_api_call, get_api_stats,
     get_slowest_functions, performance_monitor
@@ -48,8 +48,8 @@ def main():
         instructions="""You are a research assistant that helps find information.
         Use the available tools to search for information and provide comprehensive answers.
         Be thorough in your research and cite your sources.""",
-        llm="gpt-5-nano",
-        tools=[duckduckgo, wikipedia]  # Add search tools
+        llm="gpt-4o-mini",
+        tools=[duckduckgo, wikipedia_tools]  # Add search tools
     )
     
     # Test queries to demonstrate tool performance monitoring
@@ -97,7 +97,9 @@ def main():
     # Slowest functions analysis
     print("\n🐌 Slowest Functions:")
     slowest = get_slowest_functions()
-    for func_name, avg_time in slowest:
+    for item in slowest[:5]:
+        func_name = item.get('function', 'unknown')
+        avg_time = item.get('average_time', 0)
         print(f"  {func_name}: {avg_time:.3f}s average")
     
     # Real-time performance data

src/praisonai-agents/04_async_agent_monitoring.py

@@ -54,7 +54,7 @@ async def run_async_agent(query: str):
     # Create agent
     agent = Agent(
         instructions="You are an efficient AI assistant that processes requests quickly",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     # Track the agent execution

src/praisonai-agents/05_error_handling_monitoring.py

@@ -60,7 +60,7 @@ def run_robust_agent(query: str, with_error_simulation: bool = True):
         instructions="""You are a resilient AI assistant. 
         Even when facing challenges, you provide helpful responses.
         If you encounter errors, acknowledge them and offer alternatives.""",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     try:

src/praisonai-agents/06_memory_agent_monitoring.py

@@ -65,7 +65,7 @@ def run_stateful_agent(query: str, session_id: str, conversation_turn: int):
         instructions="""You are a memory-enabled AI assistant. You can remember 
         previous conversations and build on past interactions. Use your memory 
         to provide personalized and contextual responses.""",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     # Pre-processing: retrieve relevant memories
@@ -165,7 +165,9 @@ def main():
     # Slowest operations
     print("\n🐌 Slowest Memory Operations:")
     slowest = get_slowest_functions()
-    for func_name, avg_time in slowest[:5]:  # Top 5 slowest
+    for item in slowest[:5]:  # Top 5 slowest
+        func_name = item.get('function', 'unknown')
+        avg_time = item.get('average_time', 0)
         print(f"  {func_name}: {avg_time:.3f}s average")
     
     # Memory operation breakdown

src/praisonai-agents/07_hierarchical_agents_monitoring.py

@@ -77,7 +77,7 @@ def run_hierarchical_workflow():
         backstory="Experienced project manager with expertise in team coordination",
         instructions="""You are a project manager. Break down complex projects into tasks,
         assign them to appropriate team members, and coordinate the overall effort.""",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     # Create worker agents
@@ -87,7 +87,7 @@ def run_hierarchical_workflow():
         goal="Conduct thorough research on assigned topics",
         backstory="Expert researcher with deep analytical skills",
         instructions="You are a research specialist. Provide detailed, factual information.",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     analysis_worker = Agent(
@@ -96,7 +96,7 @@ def run_hierarchical_workflow():
         goal="Analyze data and identify patterns and insights",
         backstory="Experienced data analyst with strong analytical thinking",
         instructions="You are a data analyst. Focus on patterns, trends, and insights.",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     writing_worker = Agent(
@@ -105,7 +105,7 @@ def run_hierarchical_workflow():
         goal="Create clear, well-structured documentation and reports", 
         backstory="Professional writer specializing in technical content",
         instructions="You are a technical writer. Create clear, comprehensive reports.",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     # Project tasks

src/praisonai-agents/08_custom_tools_monitoring.py

@@ -180,7 +180,7 @@ def run_agent_with_custom_tools():
         instructions="""You are a technical assistant with access to various tools.
         Use the appropriate tools to help with data processing, API calls, database queries,
         and file operations. Always explain what tools you're using and why.""",
-        llm="gpt-5-nano",
+        llm="gpt-4o-mini",
         tools=[process_data, call_external_api, query_database, file_operation]
     )
     
@@ -263,7 +263,7 @@ def main():
     # Slowest operations
     print("\n🐌 Slowest Tool Operations:")
     slowest = get_slowest_functions()
-    tool_slowest = [(name, time) for name, time in slowest if 'tool' in name.lower()]
+    tool_slowest = [(item.get('function', 'unknown'), item.get('average_time', 0)) for item in slowest if 'tool' in item.get('function', '').lower()]
     
     for tool_name, avg_time in tool_slowest[:3]:
         print(f"  {tool_name}: {avg_time:.3f}s")

src/praisonai-agents/09_streaming_monitoring.py

@@ -60,7 +60,7 @@ def get_real_time_agent_response(query: str, response_id: int):
     # Create a lightweight agent for streaming
     agent = Agent(
         instructions="You are a real-time assistant. Provide quick, helpful responses.",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     with track_api_call(f"streaming_response_{response_id}"):

src/praisonai-agents/10_comprehensive_dashboard.py

@@ -42,19 +42,19 @@ def collect_comprehensive_data():
     agents = {
         'quick_agent': Agent(
             instructions="You are a quick-response agent. Provide concise answers.",
-            llm="gpt-5-nano"
+            llm="gpt-4o-mini"
         ),
         'analytical_agent': Agent(
             instructions="You are an analytical agent. Provide detailed analysis.",
-            llm="gpt-5-nano"
+            llm="gpt-4o-mini"
         ),
         'research_agent': Agent(
             instructions="You are a research agent. Provide comprehensive information.",
-            llm="gpt-5-nano"
+            llm="gpt-4o-mini"
         ),
         'creative_agent': Agent(
             instructions="You are a creative agent. Provide imaginative responses.",
-            llm="gpt-5-nano"
+            llm="gpt-4o-mini"
         )
     }
     
@@ -98,19 +98,19 @@ def simulate_complex_workflow():
     planner = Agent(
         name="planner",
         instructions="You are a project planner. Break down tasks and plan execution.",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     executor = Agent(
         name="executor", 
         instructions="You are a task executor. Complete assigned tasks efficiently.",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     reviewer = Agent(
         name="reviewer",
         instructions="You are a quality reviewer. Review and improve work.",
-        llm="gpt-5-nano"
+        llm="gpt-4o-mini"
     )
     
     # Create workflow tasks
@@ -143,7 +143,7 @@ def simulate_complex_workflow():
             agents=[planner, executor, reviewer],
             tasks=[planning_task, execution_task, review_task],
             process="sequential",
-            verbose=False
+            output="silent"
         )
         
         result = workflow.start()
@@ -302,13 +302,17 @@ def display_dashboard(dashboard_data, benchmark_results):
     perf_data = dashboard_data['performance_data']
     
     print("  Fastest Functions:")
-    fastest_functions = sorted(perf_data['slowest_functions'], key=lambda x: x[1])[:3]
-    for name, time in fastest_functions:
-        print(f"    {name}: {time:.3f}s")
+    fastest_functions = sorted(perf_data['slowest_functions'], key=lambda x: x.get('average_time', float('inf')))[:3]
+    for item in fastest_functions:
+        name = item.get('function', 'unknown')
+        time_val = item.get('average_time', 0)
+        print(f"    {name}: {time_val:.3f}s")
     
     print("  Slowest Functions:")
-    for name, time in perf_data['slowest_functions'][:3]:
-        print(f"    {name}: {time:.3f}s")
+    for item in perf_data['slowest_functions'][:3]:
+        name = item.get('function', 'unknown')
+        time_val = item.get('average_time', 0)
+        print(f"    {name}: {time_val:.3f}s")
     
     # Benchmark Results
     print(f"\n⚡ BENCHMARK RESULTS")

src/praisonai-agents/CLAUDE.md

@@ -1,279 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-PraisonAI Agents is a hierarchical AI agent framework for completing complex tasks with self-reflection capabilities. It supports multi-agent collaboration, tool integration, and various execution patterns (sequential, hierarchical, parallel).
-
-## Development Commands
-
-### Installation and Setup
-```bash
-# Install core package
-pip install -e .
-
-# Install with specific features
-pip install -e .[all]          # All features
-pip install -e .[memory]       # Memory capabilities
-pip install -e .[knowledge]    # Document processing
-pip install -e .[mcp]          # MCP server support
-pip install -e .[llm]          # Extended LLM support
-pip install -e .[api]          # API server capabilities
-```
-
-### Testing
-```bash
-# Run individual test examples (no formal test runner configured)
-python tests/basic-agents.py
-python tests/async_example.py
-python tests/knowledge-agents.py
-
-# Test specific features
-python tests/mcp-agents.py           # MCP integration
-python tests/memory_example.py      # Memory functionality
-python tests/tools_example.py       # Tool system
-```
-
-### Running Examples
-```bash
-# Basic agent usage
-python tests/single-agent.py
-
-# Multi-agent workflows
-python tests/multi-agents-api.py
-
-# Async operations
-python tests/async_example_full.py
-
-# MCP server examples
-python tests/mcp-sse-direct-server.py  # Start MCP server
-python tests/mcp-sse-direct-client.py  # Connect to server
-```
-
-## Core Architecture
-
-### Agent System (`praisonaiagents/agent/`)
-- **Agent**: Core agent class with LLM integration, tool calling, and self-reflection
-- **ImageAgent**: Specialized multimodal agent for image processing
-- Self-reflection with configurable min/max iterations (default: 1-3)
-- Delegation support for hierarchical agent structures
-
-### Multi-Agent Orchestration (`praisonaiagents/agents/`)
-- **PraisonAIAgents**: Main orchestrator for managing multiple agents and tasks
-- **AutoAgents**: Automatic agent creation and management
-- Process types: `sequential`, `hierarchical`, `parallel`
-- Context passing between agents and task dependency management
-
-### Task System (`praisonaiagents/task/`)
-- **Task**: Core task definition with context, callbacks, and output specifications
-- Supports file output, JSON/Pydantic structured output, async execution
-- Conditional logic with `condition` parameter for task flow control
-- Context passing via `context` parameter for task dependencies
-- **Guardrails**: Built-in validation and safety mechanisms for task outputs
-  - Function-based guardrails for custom validation logic
-  - LLM-based guardrails using natural language descriptions
-  - Automatic retry with configurable `max_retries` parameter
-  - Compatible with CrewAI guardrail patterns
-
-### LLM Integration (`praisonaiagents/llm/`)
-- Unified wrapper for multiple LLM providers via LiteLLM
-- Supports OpenAI, Anthropic, Gemini, DeepSeek, local models (Ollama)
-- Context length management and tool calling capabilities
-- Set via `llm` parameter on agents or global `OPENAI_API_KEY`/`ANTHROPIC_API_KEY`
-
-### Tool System (`praisonaiagents/tools/`)
-Two implementation patterns:
-1. **Function-based**: Simple tools using `@tool` decorator
-2. **Class-based**: Complex tools inheriting from `BaseTool`
-
-Built-in tools include: DuckDuckGo search, file operations, calculator, Wikipedia, arXiv, data analysis tools, shell execution.
-
-### Memory & Knowledge Systems
-- **Memory** (`praisonaiagents/memory/`): Multi-layered memory with RAG support
-  - Types: short-term, long-term, entity, user memory
-  - Providers: ChromaDB, Mem0, custom implementations
-- **Knowledge** (`praisonaiagents/knowledge/`): Document processing with chunking
-  - Chunking strategies via `chonkie` library
-  - Embedding and retrieval capabilities
-
-### MCP (Model Context Protocol) Integration
-- **MCP Server**: Server-side tool protocol for distributed execution
-- **SSE Support**: Server-sent events for real-time communication
-- Tool discovery and dynamic registration
-
-## Development Patterns
-
-### Agent Creation
-```python
-agent = Agent(
-    name="Agent Name",
-    role="Agent Role",
-    goal="Agent Goal",
-    backstory="Agent Background",
-    llm="gpt-5-nano",  # or other LLM
-    self_reflect=True,  # Enable self-reflection
-    min_reflect=1,      # Minimum reflection iterations
-    max_reflect=3,      # Maximum reflection iterations
-    tools=[tool1, tool2],  # Optional tools
-    guardrail=validate_function,  # Agent-level guardrail (function or string)
-    max_guardrail_retries=3  # Retry limit for guardrail failures
-)
-```
-
-### Task Definition
-```python
-task = Task(
-    name="task_name",
-    description="Task description",
-    expected_output="Expected output format",
-    agent=agent,
-    context=[previous_task],  # Task dependencies
-    output_pydantic=ResponseModel,  # Structured output
-    condition="condition_function"  # Conditional execution
-)
-```
-
-### Guardrails Usage
-
-#### Task-Level Guardrails
-```python
-from typing import Tuple, Any
-from praisonaiagents import GuardrailResult
-
-# Function-based guardrail (Option 1: Using GuardrailResult)
-def validate_output(task_output: TaskOutput) -> GuardrailResult:
-    """Custom validation function returning GuardrailResult."""
-    if "error" in task_output.raw.lower():
-        return GuardrailResult(
-            success=False,
-            result=None,
-            error="Output contains errors"
-        )
-    if len(task_output.raw) < 10:
-        return GuardrailResult(
-            success=False,
-            result=None,
-            error="Output is too short"
-        )
-    return GuardrailResult(
-        success=True,
-        result=task_output,
-        error=""
-    )
-
-# Function-based guardrail (Option 2: Using Tuple[bool, Any])
-def validate_output_tuple(task_output: TaskOutput) -> Tuple[bool, Any]:
-    """Custom validation function returning tuple."""
-    if "error" in task_output.raw.lower():
-        return False, "Output contains errors"
-    if len(task_output.raw) < 10:
-        return False, "Output is too short"
-    return True, task_output
-
-task = Task(
-    description="Write a professional email",
-    expected_output="A well-formatted email",
-    agent=agent,
-    guardrail=validate_output,  # Function-based guardrail
-    max_retries=3  # Retry up to 3 times if guardrail fails
-)
-
-# LLM-based guardrail
-task = Task(
-    description="Generate marketing copy",
-    expected_output="Professional marketing content",
-    agent=agent,
-    guardrail="Ensure the content is professional, engaging, and free of errors",  # String description
-    max_retries=2
-)
-```
-
-#### Agent-Level Guardrails
-```python
-# Agent guardrails apply to ALL outputs from that agent
-
-# Option 1: Using GuardrailResult
-def validate_professional_tone(task_output: TaskOutput) -> GuardrailResult:
-    """Ensure professional tone in all agent responses."""
-    content = task_output.raw.lower()
-    casual_words = ['yo', 'dude', 'awesome', 'cool']
-    for word in casual_words:
-        if word in content:
-            return GuardrailResult(
-                success=False,
-                result=None,
-                error=f"Unprofessional language detected: {word}"
-            )
-    return GuardrailResult(
-        success=True,
-        result=task_output,
-        error=""
-    )
-
-# Option 2: Using Tuple[bool, Any]
-def validate_professional_tone_tuple(task_output: TaskOutput) -> Tuple[bool, Any]:
-    """Ensure professional tone in all agent responses."""
-    content = task_output.raw.lower()
-    casual_words = ['yo', 'dude', 'awesome', 'cool']
-    for word in casual_words:
-        if word in content:
-            return False, f"Unprofessional language detected: {word}"
-    return True, task_output
-
-# Agent with function-based guardrail
-agent = Agent(
-    name="BusinessWriter",
-    instructions="You are a professional business writer",
-    guardrail=validate_professional_tone,  # Function guardrail
-    max_guardrail_retries=3
-)
-
-# Agent with LLM-based guardrail
-agent = Agent(
-    name="ContentWriter", 
-    instructions="You are a content writer",
-    guardrail="Ensure all responses are professional, accurate, and appropriate for business use",  # String guardrail
-    max_guardrail_retries=2
-)
-```
-
-### Multi-Agent Workflow
-```python
-workflow = PraisonAIAgents(
-    agents=[agent1, agent2],
-    tasks=[task1, task2],
-    process="sequential",  # or "hierarchical", "parallel"
-    verbose=True,
-    manager_agent=manager_agent  # For hierarchical process
-)
-result = workflow.start()
-```
-
-### Async Support
-All major components support async execution:
-```python
-result = await workflow.astart()
-result = await agent.aexecute(task)
-```
-
-## Key Dependencies
-
-- **Core**: `pydantic`, `rich`, `openai`, `mcp`
-- **Memory**: `chromadb`, `mem0ai`
-- **Knowledge**: `markitdown`, `chonkie`
-- **LLM**: `litellm` for unified provider access
-- **API**: `fastapi`, `uvicorn` for server capabilities
-
-## Error Handling
-
-- Global error logging via `error_logs` list
-- Callback system for real-time error reporting
-- Context length exception handling with automatic retry
-- Graceful degradation for optional dependencies
-
-## Testing Strategy
-
-The project uses example-driven testing with 100+ test files in `tests/` directory. Each test file demonstrates specific usage patterns and serves as both test and documentation. Run individual examples to test functionality rather than using a formal test runner.
-
-Use conda activate praisonai-agents to activate the environment.

src/praisonai-agents/agent-profile.py

@@ -0,0 +1,63 @@
+"""
+Streaming Example with Profiling
+
+Key Points:
+1. output="stream" preset enables streaming by default
+2. stream=True in start() is redundant when using output="stream" (but doesn't hurt)
+3. Profiler.enable() MUST be called before profiling works
+4. Use Profiler.streaming() context manager for TTFT metrics
+"""
+from praisonai.profiler import Profiler, profile, profile_imports
+
+# IMPORTANT: Enable profiler BEFORE any profiling operations
+Profiler.enable()
+
+# Profile imports
+with profile_imports():
+    from praisonaiagents import Agent
+
+@profile
+def main():
+    agent = Agent(
+        instructions="You are a helpful assistant",
+        output="stream"  # This already enables streaming
+    )
+
+    print("\nStreaming response:")
+    print("-" * 40)
+    
+    # Use Profiler.streaming() to track TTFT (Time To First Token)
+    with Profiler.streaming("llm_stream") as tracker:
+        first_chunk = True
+        for chunk in agent.start("Write a short paragraph about the history of computing"):
+            if first_chunk:
+                tracker.first_token()  # Mark TTFT
+                first_chunk = False
+            tracker.chunk()  # Count chunks
+            print(chunk, end="", flush=True)
+    
+    print("\n" + "-" * 40)
+
+# Run with profiling blocks
+with Profiler.block("full_workflow"):
+    with Profiler.block("setup"):
+        pass
+    
+    with Profiler.block("execution"):
+        result = main()
+    
+    with Profiler.block("cleanup"):
+        pass
+
+# Generate report
+Profiler.report()
+
+# Show streaming-specific stats
+streaming_records = Profiler.get_streaming_records()
+if streaming_records:
+    print("\nStreaming Metrics:")
+    for record in streaming_records:
+        print(f"  {record.name}: TTFT={record.ttft_ms:.2f}ms, Total={record.total_ms:.2f}ms, Chunks={record.chunk_count}")
+
+stats = Profiler.get_statistics()
+print(f"\nMedian execution time: {stats['p50']:.2f}ms")

src/praisonai-agents/agent_guardrails_example.py

@@ -1,21 +1,21 @@
 #!/usr/bin/env python3
 """
 Agent-level guardrails example.
-
-This example demonstrates how to use guardrails at the Agent level,
+This example demonstrates how to use guardrails at the Agent level
 which will apply to all tasks executed by that agent.
-"""
 
+Note: Agent guardrails only support function-based validation or preset strings
+(permissive, safety, strict). For LLM-based guardrails, use Task guardrails.
+"""
 from typing import Tuple, Any
 from praisonaiagents import Agent, TaskOutput
 
+
 def validate_content_length(task_output: TaskOutput) -> Tuple[bool, Any]:
     """
     Validate that task output content meets minimum length requirement.
-    
     Args:
         task_output: The task output to validate
-        
     Returns:
         Tuple of (success, result_or_error_message)
     """
@@ -23,76 +23,70 @@ def validate_content_length(task_output: TaskOutput) -> Tuple[bool, Any]:
         return False, "Content too short - must be at least 50 characters"
     return True, task_output
 
+
 def validate_professional_tone(task_output: TaskOutput) -> Tuple[bool, Any]:
     """
     Validate that the content has a professional tone.
-    
     Args:
         task_output: The task output to validate
-        
     Returns:
         Tuple of (success, result_or_error_message)
     """
     content = task_output.raw.lower()
     unprofessional_words = ['yo', 'dude', 'awesome', 'cool', 'lol']
-    
     for word in unprofessional_words:
         if word in content:
             return False, f"Content contains unprofessional word: '{word}'"
-    
     return True, task_output
 
+
 def main():
-    """Demonstrate Agent-level guardrails with function-based and LLM-based validation."""
-    
+    """Demonstrate Agent-level guardrails with function-based validation."""
     print("=== Agent Guardrail Examples ===\n")
     
-    # Example 1: Function-based guardrail
+    # Example 1: Function-based guardrail for content length
     print("1. Function-based guardrail (content length validation):")
     agent1 = Agent(
         name="ContentWriter",
         instructions="You are a professional content writer who creates detailed responses",
-        guardrail=validate_content_length,
-        max_guardrail_retries=2
+        guardrails=validate_content_length
     )
-    
     try:
         result1 = agent1.start("Write a brief welcome message")
         print(f"Result: {result1}\n")
     except Exception as e:
         print(f"Error: {e}\n")
     
-    # Example 2: LLM-based guardrail (string description)
-    print("2. LLM-based guardrail (professional tone validation):")
+    # Example 2: Function-based guardrail for professional tone
+    print("2. Function-based guardrail (professional tone validation):")
     agent2 = Agent(
         name="BusinessWriter", 
-        instructions="You are a business communication expert",
-        guardrail="Ensure the content is professional, formal, and suitable for business communication. No casual language or slang.",
-        max_guardrail_retries=3
+        instructions="You are a business communication expert. Write formal, professional content.",
+        guardrails=validate_professional_tone
     )
-    
     try:
         result2 = agent2.start("Write a welcome message for new employees")
         print(f"Result: {result2}\n")
     except Exception as e:
         print(f"Error: {e}\n")
     
-    # Example 3: Multiple agents with different guardrails
-    print("3. Professional tone function-based guardrail:")
+    # Example 3: Using preset guardrails (built-in options)
+    print("3. Using preset guardrail ('safety'):")
     agent3 = Agent(
-        name="ProfessionalWriter",
-        instructions="Write professional business content",
-        guardrail=validate_professional_tone,
-        max_guardrail_retries=2
+        name="SafeWriter",
+        instructions="Write helpful content",
+        guardrails="safety"  # Valid presets: permissive, safety, strict
     )
-    
     try:
-        result3 = agent3.start("Write a casual greeting message")
+        result3 = agent3.start("Write a friendly greeting message")
         print(f"Result: {result3}\n")
     except Exception as e:
         print(f"Error: {e}\n")
     
     print("=== Agent Guardrails Demonstration Complete ===")
+    print("\nNote: For LLM-based guardrails with custom descriptions,")
+    print("use Task-level guardrails instead of Agent-level guardrails.")
+
 
 if __name__ == "__main__":
     main()

src/praisonai-agents/agentic_parallelisation.py

@@ -21,7 +21,7 @@ article_agent = Agent(
     goal="Fetch the user's favorite morning article",
     tools=[fetch_favorite_article],
     llm="gemini/gemini-2.5-flash-lite-preview-06-17",
-    verbose=True
+    output="verbose"
 )
 
 news_agent = Agent(
@@ -30,7 +30,7 @@ news_agent = Agent(
     goal="Search for trending news in Kenya",
     tools=[search_trending_kenya],
     llm="gemini/gemini-2.5-flash-lite-preview-06-17",
-    verbose=True
+    output="verbose"
 )
 
 twitter_agent = Agent(
@@ -39,7 +39,7 @@ twitter_agent = Agent(
     goal="Fetch the latest Twitter feed",
     tools=[fetch_twitter_feed],
     llm="gemini/gemini-2.5-flash-lite-preview-06-17",
-    verbose=True
+    output="verbose"
 )
 
 aggregator = Agent(
@@ -47,7 +47,7 @@ aggregator = Agent(
     role="Result Aggregator",
     goal="Aggregate and summarize all results",
     llm="gemini/gemini-2.5-flash-lite-preview-06-17",
-    verbose=True
+    output="verbose"
 )
 
 # Tasks for each agent
@@ -92,7 +92,7 @@ async def main():
         agents=[article_agent, news_agent, twitter_agent, aggregator],
         tasks=[article_task, news_task, twitter_task, aggregate_task],
         process="workflow",
-        verbose=True
+        output="verbose"
     )
     results = await workflow.astart(dict_output=True)
 

src/praisonai-agents/any-llm-agents-async.py

@@ -5,8 +5,8 @@ async def main():
     agent = Agent(
         instructions="You are a helpful assistant",
         llm="gemini/gemini-1.5-flash-8b",
-        self_reflect=True,
-        verbose=True
+        reflection=True,
+        output="verbose"
     )
 
     # Use achat instead of start/chat for async operation

src/praisonai-agents/async-tavily-agents-gemini.py

@@ -10,7 +10,7 @@ import os
 logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
 
 llm_config = {
-    "model": "gpt-5-nano",  # Changed from Gemini to gpt-5-nano for better tool support
+    "model": "gpt-4o-mini",  # Changed from Gemini to gpt-5-nano for better tool support
     "temperature": 0.7,
     "response_format": {
         "type": "text"
@@ -79,7 +79,7 @@ async def run_parallel_searches():
         backstory="Expert in web search and information retrieval. You have access to the tavily_search tool to search the web.",
         tools=[tavily_search],
         llm=llm_config,
-        verbose=True
+        output="verbose"
     )
     
     # Create summary agent

src/praisonai-agents/autoagents-tavily.py

@@ -11,7 +11,7 @@ agents = AutoAgents(
     instructions="Search for information about AI Agents",
     tools=[tavily],
     process="sequential",
-    verbose=True,
+    output="verbose",
     max_agents=3  # Maximum number of agents to create
 )
 
@@ -52,8 +52,8 @@ agents = AutoAgents(
     tools=[evaluate, get_stock_price],
     process="sequential",
     llm="gemini/gemini-2.5-flash-lite-preview-06-17",
-    self_reflect=False,
-    verbose=False,
+    reflection=False,
+    output="silent",
     max_agents=3  # Maximum number of agents to create
 )
 

src/praisonai-agents/basic-agents-tools.py

@@ -5,8 +5,9 @@ def get_weather(city: str) -> str:
 
 agent = Agent(
     instructions="You are a helpful assistant",
-    llm="gpt-5-nano",
-    tools=[get_weather]
+    llm="gpt-4o-mini",
+    tools=[get_weather],
+    output="status"
 )
 
 agent.start("What is the weather in Tokyo?")

src/praisonai-agents/basic-agents.py

@@ -1,14 +1,3 @@
-#!/usr/bin/env python3
-
 from praisonaiagents import Agent
-
-print("Creating agent...")
-agent = Agent(
-    instructions="You are a helpful assistant"
-)
-
-print("Starting agent...")
-result = agent.start("Why is the sky blue?")
-
-print("Agent completed successfully!")
-print(f"Result: {result}") 
+agent = Agent(instructions="You are a helpful assistant")
+result = agent.start("Why is the sky blue?")

src/praisonai-agents/benchmarks/EXECUTION_BENCHMARK_RESULTS.md

@@ -1,6 +1,6 @@
 # PraisonAI Agents - Real Execution Benchmark
 
-**Generated:** 2025-12-18 14:43:52
+**Generated:** 2026-01-13 06:07:28
 **Model:** gpt-4o-mini
 **Iterations:** 3
 **Prompt:** "What is 2+2? Reply with just the number."
@@ -9,18 +9,18 @@
 
 | Framework | Method | Avg Time | Relative |
 |-----------|--------|----------|----------|
-| **PraisonAI** | `agent.start()` | **0.45s** | **1.00x (fastest)** |
-| PraisonAI (LiteLLM) | `agent.start()` | 0.55s | 1.22x |
-| CrewAI | `crew.kickoff()` | 0.58s | 1.28x |
-| Agno | `agent.run()` | 0.92s | 2.05x |
+| **PraisonAI (LiteLLM)** | `agent.start()` | **0.55s** | **1.00x (fastest)** |
+| PraisonAI | `agent.start()` | 0.64s | 1.15x |
+| CrewAI | `crew.kickoff()` | 0.95s | 1.71x |
+| Agno | `agent.run()` | 1.05s | 1.90x |
 
 ## Package Versions
 
 | Package | Version |
 |---------|--------|
-| PraisonAI | 0.1.5 |
-| Agno | 2.3.14 |
-| CrewAI | 1.6.1 |
+| PraisonAI | 0.11.7 |
+| Agno | 2.3.25 |
+| CrewAI | 1.8.0 |
 
 ## How to Reproduce
 

src/praisonai-agents/benchmarks/REAL_BENCHMARK_RESULTS.md

@@ -1,6 +1,6 @@
 # PraisonAI Agents - Real-World Execution Benchmark
 
-**Generated:** 2025-12-18 14:33:49
+**Generated:** 2026-01-13 14:42:59
 **Model:** gpt-4o-mini
 **Iterations:** 3 per test
 
@@ -8,60 +8,60 @@
 
 | Test | PraisonAI (avg) | Agno (avg) | Difference |
 |------|-----------------|------------|------------|
-| Single Agent | 2.04s | 3.18s | PraisonAI 1.56x faster |
-| 2 Agents | 2.49s | 20.49s | PraisonAI 8.21x faster |
-| 3 Agents | 6.52s | 13.97s | PraisonAI 2.14x faster |
+| Single Agent | 2.46s | 2.92s | PraisonAI 1.19x faster |
+| 2 Agents | 3.21s | 19.39s | PraisonAI 6.05x faster |
+| 3 Agents | 8.26s | 15.01s | PraisonAI 1.82x faster |
 
 ## Detailed Results
 
 ### praisonai_single
-- Average: 2.04s
-- Min: 1.95s
-- Max: 2.19s
-- Std Dev: 0.13s
-- Times: ['2.19s', '1.95s', '2.00s']
+- Average: 2.46s
+- Min: 1.93s
+- Max: 2.90s
+- Std Dev: 0.49s
+- Times: ['1.93s', '2.55s', '2.90s']
 
 ### agno_single
-- Average: 3.18s
-- Min: 3.00s
-- Max: 3.51s
-- Std Dev: 0.28s
-- Times: ['3.51s', '3.00s', '3.04s']
+- Average: 2.92s
+- Min: 2.85s
+- Max: 2.97s
+- Std Dev: 0.06s
+- Times: ['2.97s', '2.85s', '2.94s']
 
 ### praisonai_two_agents
-- Average: 2.49s
-- Min: 2.22s
-- Max: 2.65s
-- Std Dev: 0.24s
-- Times: ['2.65s', '2.22s', '2.62s']
+- Average: 3.21s
+- Min: 2.80s
+- Max: 3.67s
+- Std Dev: 0.44s
+- Times: ['3.67s', '2.80s', '3.15s']
 
 ### agno_two_agents
-- Average: 20.49s
-- Min: 9.96s
-- Max: 35.05s
-- Std Dev: 13.02s
-- Times: ['16.46s', '9.96s', '35.05s']
+- Average: 19.39s
+- Min: 10.62s
+- Max: 26.06s
+- Std Dev: 7.93s
+- Times: ['26.06s', '10.62s', '21.50s']
 
 ### praisonai_three_agents
-- Average: 6.52s
-- Min: 5.62s
-- Max: 7.39s
-- Std Dev: 0.88s
-- Times: ['5.62s', '6.54s', '7.39s']
+- Average: 8.26s
+- Min: 6.44s
+- Max: 11.88s
+- Std Dev: 3.13s
+- Times: ['6.47s', '6.44s', '11.88s']
 
 ### agno_three_agents
-- Average: 13.97s
-- Min: 11.69s
-- Max: 15.32s
-- Std Dev: 1.99s
-- Times: ['14.91s', '11.69s', '15.32s']
+- Average: 15.01s
+- Min: 14.46s
+- Max: 15.90s
+- Std Dev: 0.78s
+- Times: ['15.90s', '14.46s', '14.68s']
 
 ## Package Versions
 
 | Package | Version |
 |---------|--------|
-| PraisonAI | 0.1.5 |
-| Agno | 2.3.14 |
+| PraisonAI | 0.11.22 |
+| Agno | 2.3.25 |
 
 ## How to Reproduce
 

src/praisonai-agents/benchmarks/execution_benchmark.py

@@ -52,12 +52,11 @@ def benchmark_praisonai(model, iterations, prompt):
         agent = Agent(
             name="Calculator",
             instructions="You are a helpful assistant. Be very brief.",
-            llm=model,
-            verbose=False
+            llm=model
         )
         
         start = time.perf_counter()
-        response = agent.start(prompt)
+        response = agent.start(prompt, output="silent")
         elapsed = time.perf_counter() - start
         
         times.append(elapsed)
@@ -80,12 +79,11 @@ def benchmark_praisonai_litellm(model, iterations, prompt):
         agent = Agent(
             name="Calculator",
             instructions="You are a helpful assistant. Be very brief.",
-            llm=f"openai/{model}",
-            verbose=False
+            llm=f"openai/{model}"
         )
         
         start = time.perf_counter()
-        response = agent.start(prompt)
+        response = agent.start(prompt, output="silent")
         elapsed = time.perf_counter() - start
         
         times.append(elapsed)

src/praisonai-agents/benchmarks/real_benchmark.py

@@ -103,12 +103,11 @@ def benchmark_praisonai_single(iterations: int = 3) -> ExecutionResult:
             name="Assistant",
             instructions="You are a helpful assistant. Be very brief.",
             llm="gpt-4o-mini",
-            tools=[get_weather],
-            verbose=False
+            tools=[get_weather]
         )
         
         start = time.perf_counter()
-        response = agent.start("What's the weather in NYC? Reply in one sentence.")
+        response = agent.start("What's the weather in NYC? Reply in one sentence.", output="silent")
         elapsed = time.perf_counter() - start
         
         result.times.append(elapsed)
@@ -132,8 +131,7 @@ def benchmark_praisonai_two_agents(iterations: int = 3) -> ExecutionResult:
             goal="Gather weather information",
             instructions="Get weather data and pass to reporter. Be brief.",
             llm="gpt-4o-mini",
-            tools=[get_weather],
-            verbose=False
+            tools=[get_weather]
         )
         
         reporter = Agent(
@@ -141,18 +139,16 @@ def benchmark_praisonai_two_agents(iterations: int = 3) -> ExecutionResult:
             role="News Reporter",
             goal="Create weather report",
             instructions="Create a one-sentence weather summary.",
-            llm="gpt-4o-mini",
-            verbose=False
+            llm="gpt-4o-mini"
         )
         
         agents = Agents(
             agents=[researcher, reporter],
-            process="sequential",
-            verbose=False
+            process="sequential"
         )
         
         start = time.perf_counter()
-        response = agents.start("Get NYC weather and create a brief report.")
+        response = agents.start("Get NYC weather and create a brief report.", output="silent")
         elapsed = time.perf_counter() - start
         
         result.times.append(elapsed)
@@ -176,8 +172,7 @@ def benchmark_praisonai_three_agents(iterations: int = 3) -> ExecutionResult:
             goal="Get weather data",
             instructions="Fetch weather information. Be brief.",
             llm="gpt-4o-mini",
-            tools=[get_weather],
-            verbose=False
+            tools=[get_weather]
         )
         
         time_agent = Agent(
@@ -186,8 +181,7 @@ def benchmark_praisonai_three_agents(iterations: int = 3) -> ExecutionResult:
             goal="Get time information",
             instructions="Fetch timezone information. Be brief.",
             llm="gpt-4o-mini",
-            tools=[get_time],
-            verbose=False
+            tools=[get_time]
         )
         
         summarizer = Agent(
@@ -195,18 +189,16 @@ def benchmark_praisonai_three_agents(iterations: int = 3) -> ExecutionResult:
             role="Summary Writer",
             goal="Combine information",
             instructions="Create a one-sentence summary combining weather and time.",
-            llm="gpt-4o-mini",
-            verbose=False
+            llm="gpt-4o-mini"
         )
         
         agents = Agents(
             agents=[weather_agent, time_agent, summarizer],
-            process="sequential",
-            verbose=False
+            process="sequential"
         )
         
         start = time.perf_counter()
-        response = agents.start("Get NYC weather and EST time, then summarize.")
+        response = agents.start("Get NYC weather and EST time, then summarize.", output="silent")
         elapsed = time.perf_counter() - start
         
         result.times.append(elapsed)

src/praisonai-agents/context_basic.py

@@ -1,5 +1,5 @@
 from praisonaiagents import ContextAgent
 
-agent = ContextAgent(llm="gpt-5-nano", auto_analyze=False)
+agent = ContextAgent(llm="gpt-4o-mini", auto_analyze=False)
 
 agent.start("https://github.com/MervinPraison/PraisonAI/ Need to add Authentication")

src/praisonai-agents/debug_comparison.py

@@ -14,7 +14,7 @@ def test_agent_direct():
         agent = Agent(
             instructions="""You are a helpful assistant that can break down complex problems.
             Use the available tools when relevant to perform step-by-step analysis.""",
-            llm="gpt-5-nano",
+            llm="gpt-4o-mini",
             tools=MCP("npx -y @modelcontextprotocol/server-sequential-thinking")
         )
         

src/praisonai-agents/deepresearch_gemini.py

@@ -26,7 +26,6 @@ agent = DeepResearchAgent(
     - Clear structure with executive summary
     """,
     model="deep-research-pro",  # Auto-detected as Gemini
-    verbose=True,
 )
 
 print(f"Agent: {agent}")
@@ -39,7 +38,7 @@ result = agent.research(
     # stream=True is the default, set stream=False to disable
 )
 
-# The report is already printed during streaming when verbose=True
+# The report is already printed during streaming when output="verbose"
 # But we can also access it programmatically:
 print("\n" + "=" * 60)
 print(f"Report length: {len(result.report)} characters")

src/praisonai-agents/deepresearch_openai.py

@@ -25,7 +25,6 @@ agent = DeepResearchAgent(
     - Clear, structured responses
     """,
     model="o4-mini-deep-research",  # or "o3-deep-research" for higher quality
-    verbose=True
 )
 
 print(f"Agent: {agent}")
@@ -38,7 +37,7 @@ result = agent.research(
     # stream=True is the default, set stream=False to disable
 )
 
-# The report is already printed during streaming when verbose=True
+# The report is already printed during streaming when output="verbose"
 # But we can also access it programmatically:
 print("\n" + "=" * 60)
 print(f"Report length: {len(result.report)} characters")