Release v3.9.4

- 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

@@ -0,0 +1,445 @@
+# PraisonAI API Reference
+
+This file is auto-generated. Do not edit manually.
+Regenerate with: `praisonai docs api-md --write`
+
+# Agents
+
+Types:
+```python
+from praisonaiagents import Agent, Agents
+```
+
+Methods:
+
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">achat</a>(prompt: str, temperature = 1.0, tools = None, output_json = None, output_pydantic = None, reasoning_steps = False, task_name = None, task_description = None, task_id = None)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">aexecute</a>(task, context = None)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">agent_id</a>()</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">analyze_prompt</a>(prompt: str) -> set</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">arun</a>(prompt: str, **kwargs)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">astart</a>(prompt: str, **kwargs)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">auto_memory</a>()</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">auto_memory</a>(value)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">background</a>()</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">background</a>(value)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">chat</a>(prompt, temperature = 1.0, tools = None, output_json = None, output_pydantic = None, reasoning_steps = False, stream = None, task_name = None, task_description = None, task_id = None, config = None, force_retrieval = False, skip_retrieval = False)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">chat_with_context</a>(message: str, context: 'ContextPack', **kwargs) -> str</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">checkpoints</a>()</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">checkpoints</a>(value)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">clean_json_output</a>(output: str) -> str</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">clear_history</a>()</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">console</a>()</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">context_manager</a>()</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">context_manager</a>(value)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">display_generating</a>(content: str, start_time: float)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">execute</a>(task, context = None)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">execute_tool</a>(function_name, arguments)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">execute_tool_async</a>(function_name: str, arguments: Dict[str, Any]) -> Any</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">from_template</a>(uri: str, config: Optional[Dict[str, Any]] = None, offline: bool = False, **kwargs) -> 'Agent'</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">generate_task</a>() -> 'Task'</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">get_available_tools</a>() -> List[Any]</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">get_memory_context</a>(query: Optional[str] = None) -> str</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">get_recommended_stage</a>(prompt: str) -> str</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">get_rules_context</a>(file_path: Optional[str] = None, include_manual: Optional[List[str]] = None) -> str</code>
+* <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>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">output_style</a>(value)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">policy</a>()</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">policy</a>(value)</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">query</a>(question: str, **kwargs) -> 'RAGResult'</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">rag</a>()</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">rag_query</a>(question: str, **kwargs) -> 'RAGResult'</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">retrieval_config</a>()</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">retrieve</a>(query: str, **kwargs) -> 'ContextPack'</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">rules_manager</a>()</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">run</a>(prompt: str, **kwargs)</code>
+* <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 = 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>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">thinking_budget</a>(value)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">add_task</a>(task)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">aexecute_task</a>(task_id)</code>
+* <code title="class Agents">Agents.<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 Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">arun_all_tasks</a>()</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">arun_task</a>(task_id)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">astart</a>(content = None, return_dict = False, **kwargs)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">clean_json_output</a>(output: str) -> str</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">clear_state</a>() -> None</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">context_manager</a>()</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">current_plan</a>()</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">default_completion_checker</a>(task, agent_output)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">delete_state</a>(key: str) -> bool</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">display_token_usage</a>()</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">execute_task</a>(task_id)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_agent_details</a>(agent_name)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_all_state</a>() -> Dict[str, Any]</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_all_tasks_status</a>()</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_detailed_token_report</a>() -> Dict[str, Any]</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_plan_markdown</a>() -> str</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_state</a>(key: str, default: Any = None) -> Any</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_task_details</a>(task_id)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_task_result</a>(task_id)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_task_status</a>(task_id)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_todo_markdown</a>() -> str</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">get_token_usage_summary</a>() -> Dict[str, Any]</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">has_state</a>(key: str) -> bool</code>
+* <code title="class Agents">Agents.<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 Agents">Agents.<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 Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">restore_session_state</a>(session_id: str) -> bool</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">run</a>(content = None, return_dict = False, **kwargs)</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">run_all_tasks</a>()</code>
+* <code title="class Agents">Agents.<a href="./src/praisonai-agents/praisonaiagents/agents/agents.py">run_task</a>(task_id)</code>
+* <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, 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>
+
+# Tools
+
+Types:
+```python
+from praisonaiagents import Tools, tool
+```
+
+Methods:
+
+* <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>
+
+# Other
+
+Types:
+```python
+from praisonaiagents import Task
+```
+
+Methods:
+
+* <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>
+* <code title="class Task">Task.<a href="./src/praisonai-agents/praisonaiagents/task/task.py">store_in_memory</a>(content: str, agent_name: str = None, task_id: str = None)</code>
+
+# Wrapper (praisonai)
+
+Types:
+```python
+from praisonai import CloudProvider, Deploy, DeployConfig, DeployType, PraisonAI, __version__
+```
+
+# CLI
+
+Methods:
+
+* <code title="cli">praisonai <a href="./src/praisonai/praisonai/cli/main.py">--help</a></code>
+* <code title="cli">praisonai acp acp-main <a href="./src/praisonai/praisonai/cli/commands/acp.py">--help</a></code>
+* <code title="cli">praisonai agents create <a href="./src/praisonai/praisonai/cli/commands/agents.py">--help</a></code>
+* <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>
+* <code title="cli">praisonai benchmark compare <a href="./src/praisonai/praisonai/cli/commands/benchmark.py">--help</a></code>
+* <code title="cli">praisonai benchmark litellm <a href="./src/praisonai/praisonai/cli/commands/benchmark.py">--help</a></code>
+* <code title="cli">praisonai benchmark profile <a href="./src/praisonai/praisonai/cli/commands/benchmark.py">--help</a></code>
+* <code title="cli">praisonai benchmark sdk <a href="./src/praisonai/praisonai/cli/commands/benchmark.py">--help</a></code>
+* <code title="cli">praisonai benchmark workflow <a href="./src/praisonai/praisonai/cli/commands/benchmark.py">--help</a></code>
+* <code title="cli">praisonai call call-main <a href="./src/praisonai/praisonai/cli/commands/call.py">--help</a></code>
+* <code title="cli">praisonai chat <a href="./src/praisonai/praisonai/cli/main.py">--help</a></code>
+* <code title="cli">praisonai chat chat-main <a href="./src/praisonai/praisonai/cli/commands/chat.py">--help</a></code>
+* <code title="cli">praisonai code <a href="./src/praisonai/praisonai/cli/main.py">--help</a></code>
+* <code title="cli">praisonai code code-main <a href="./src/praisonai/praisonai/cli/commands/code.py">--help</a></code>
+* <code title="cli">praisonai commit commit-main <a href="./src/praisonai/praisonai/cli/commands/commit.py">--help</a></code>
+* <code title="cli">praisonai completion bash <a href="./src/praisonai/praisonai/cli/commands/completion.py">--help</a></code>
+* <code title="cli">praisonai completion completion-callback <a href="./src/praisonai/praisonai/cli/commands/completion.py">--help</a></code>
+* <code title="cli">praisonai completion fish <a href="./src/praisonai/praisonai/cli/commands/completion.py">--help</a></code>
+* <code title="cli">praisonai completion zsh <a href="./src/praisonai/praisonai/cli/commands/completion.py">--help</a></code>
+* <code title="cli">praisonai config get <a href="./src/praisonai/praisonai/cli/commands/config.py">--help</a></code>
+* <code title="cli">praisonai config list <a href="./src/praisonai/praisonai/cli/commands/config.py">--help</a></code>
+* <code title="cli">praisonai config path <a href="./src/praisonai/praisonai/cli/commands/config.py">--help</a></code>
+* <code title="cli">praisonai config reset <a href="./src/praisonai/praisonai/cli/commands/config.py">--help</a></code>
+* <code title="cli">praisonai config set <a href="./src/praisonai/praisonai/cli/commands/config.py">--help</a></code>
+* <code title="cli">praisonai context add <a href="./src/praisonai/praisonai/cli/commands/context.py">--help</a></code>
+* <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>
+* <code title="cli">praisonai debug lsp <a href="./src/praisonai/praisonai/cli/commands/debug.py">--help</a></code>
+* <code title="cli">praisonai debug trace <a href="./src/praisonai/praisonai/cli/commands/debug.py">--help</a></code>
+* <code title="cli">praisonai deploy aws <a href="./src/praisonai/praisonai/cli/commands/deploy.py">--help</a></code>
+* <code title="cli">praisonai deploy azure <a href="./src/praisonai/praisonai/cli/commands/deploy.py">--help</a></code>
+* <code title="cli">praisonai deploy docker <a href="./src/praisonai/praisonai/cli/commands/deploy.py">--help</a></code>
+* <code title="cli">praisonai deploy gcp <a href="./src/praisonai/praisonai/cli/commands/deploy.py">--help</a></code>
+* <code title="cli">praisonai diag diag-callback <a href="./src/praisonai/praisonai/cli/commands/diag.py">--help</a></code>
+* <code title="cli">praisonai diag export <a href="./src/praisonai/praisonai/cli/commands/diag.py">--help</a></code>
+* <code title="cli">praisonai docs api-md <a href="./src/praisonai/praisonai/cli/commands/docs.py">--help</a></code>
+* <code title="cli">praisonai docs generate <a href="./src/praisonai/praisonai/cli/commands/docs.py">--help</a></code>
+* <code title="cli">praisonai docs list <a href="./src/praisonai/praisonai/cli/commands/docs.py">--help</a></code>
+* <code title="cli">praisonai docs report <a href="./src/praisonai/praisonai/cli/commands/docs.py">--help</a></code>
+* <code title="cli">praisonai docs run <a href="./src/praisonai/praisonai/cli/commands/docs.py">--help</a></code>
+* <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>
+* <code title="cli">praisonai doctor env <a href="./src/praisonai/praisonai/cli/commands/doctor.py">--help</a></code>
+* <code title="cli">praisonai doctor mcp <a href="./src/praisonai/praisonai/cli/commands/doctor.py">--help</a></code>
+* <code title="cli">praisonai doctor network <a href="./src/praisonai/praisonai/cli/commands/doctor.py">--help</a></code>
+* <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>
+* <code title="cli">praisonai environment doctor <a href="./src/praisonai/praisonai/cli/commands/environment.py">--help</a></code>
+* <code title="cli">praisonai environment view <a href="./src/praisonai/praisonai/cli/commands/environment.py">--help</a></code>
+* <code title="cli">praisonai eval accuracy <a href="./src/praisonai/praisonai/cli/commands/eval.py">--help</a></code>
+* <code title="cli">praisonai eval performance <a href="./src/praisonai/praisonai/cli/commands/eval.py">--help</a></code>
+* <code title="cli">praisonai examples info <a href="./src/praisonai/praisonai/cli/commands/examples.py">--help</a></code>
+* <code title="cli">praisonai examples list <a href="./src/praisonai/praisonai/cli/commands/examples.py">--help</a></code>
+* <code title="cli">praisonai examples report <a href="./src/praisonai/praisonai/cli/commands/examples.py">--help</a></code>
+* <code title="cli">praisonai examples run <a href="./src/praisonai/praisonai/cli/commands/examples.py">--help</a></code>
+* <code title="cli">praisonai examples run-all <a href="./src/praisonai/praisonai/cli/commands/examples.py">--help</a></code>
+* <code title="cli">praisonai examples stats <a href="./src/praisonai/praisonai/cli/commands/examples.py">--help</a></code>
+* <code title="cli">praisonai hooks add <a href="./src/praisonai/praisonai/cli/commands/hooks.py">--help</a></code>
+* <code title="cli">praisonai hooks list <a href="./src/praisonai/praisonai/cli/commands/hooks.py">--help</a></code>
+* <code title="cli">praisonai hooks remove <a href="./src/praisonai/praisonai/cli/commands/hooks.py">--help</a></code>
+* <code title="cli">praisonai knowledge add <a href="./src/praisonai/praisonai/cli/commands/knowledge.py">--help</a></code>
+* <code title="cli">praisonai knowledge index <a href="./src/praisonai/praisonai/cli/commands/knowledge.py">--help</a></code>
+* <code title="cli">praisonai knowledge list <a href="./src/praisonai/praisonai/cli/commands/knowledge.py">--help</a></code>
+* <code title="cli">praisonai knowledge search <a href="./src/praisonai/praisonai/cli/commands/knowledge.py">--help</a></code>
+* <code title="cli">praisonai lsp logs <a href="./src/praisonai/praisonai/cli/commands/lsp.py">--help</a></code>
+* <code title="cli">praisonai lsp lsp-callback <a href="./src/praisonai/praisonai/cli/commands/lsp.py">--help</a></code>
+* <code title="cli">praisonai lsp start <a href="./src/praisonai/praisonai/cli/commands/lsp.py">--help</a></code>
+* <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>
+* <code title="cli">praisonai profile imports <a href="./src/praisonai/praisonai/cli/commands/profile.py">--help</a></code>
+* <code title="cli">praisonai profile optimize <a href="./src/praisonai/praisonai/cli/commands/profile.py">--help</a></code>
+* <code title="cli">praisonai profile profile-callback <a href="./src/praisonai/praisonai/cli/commands/profile.py">--help</a></code>
+* <code title="cli">praisonai profile query <a href="./src/praisonai/praisonai/cli/commands/profile.py">--help</a></code>
+* <code title="cli">praisonai profile snapshot <a href="./src/praisonai/praisonai/cli/commands/profile.py">--help</a></code>
+* <code title="cli">praisonai profile startup <a href="./src/praisonai/praisonai/cli/commands/profile.py">--help</a></code>
+* <code title="cli">praisonai profile suite <a href="./src/praisonai/praisonai/cli/commands/profile.py">--help</a></code>
+* <code title="cli">praisonai rag chat <a href="./src/praisonai/praisonai/cli/commands/rag.py">--help</a></code>
+* <code title="cli">praisonai rag eval <a href="./src/praisonai/praisonai/cli/commands/rag.py">--help</a></code>
+* <code title="cli">praisonai rag index <a href="./src/praisonai/praisonai/cli/commands/rag.py">--help</a></code>
+* <code title="cli">praisonai rag query <a href="./src/praisonai/praisonai/cli/commands/rag.py">--help</a></code>
+* <code title="cli">praisonai rag serve <a href="./src/praisonai/praisonai/cli/commands/rag.py">--help</a></code>
+* <code title="cli">praisonai realtime realtime-main <a href="./src/praisonai/praisonai/cli/commands/realtime.py">--help</a></code>
+* <code title="cli">praisonai recipe install <a href="./src/praisonai/praisonai/cli/commands/recipe.py">--help</a></code>
+* <code title="cli">praisonai recipe list <a href="./src/praisonai/praisonai/cli/commands/recipe.py">--help</a></code>
+* <code title="cli">praisonai recipe run <a href="./src/praisonai/praisonai/cli/commands/recipe.py">--help</a></code>
+* <code title="cli">praisonai registry list <a href="./src/praisonai/praisonai/cli/commands/registry.py">--help</a></code>
+* <code title="cli">praisonai registry serve <a href="./src/praisonai/praisonai/cli/commands/registry.py">--help</a></code>
+* <code title="cli">praisonai research research-main <a href="./src/praisonai/praisonai/cli/commands/research.py">--help</a></code>
+* <code title="cli">praisonai retrieval index <a href="./src/praisonai/praisonai/cli/commands/retrieval.py">--help</a></code>
+* <code title="cli">praisonai retrieval query <a href="./src/praisonai/praisonai/cli/commands/retrieval.py">--help</a></code>
+* <code title="cli">praisonai retrieval search <a href="./src/praisonai/praisonai/cli/commands/retrieval.py">--help</a></code>
+* <code title="cli">praisonai rules add <a href="./src/praisonai/praisonai/cli/commands/rules.py">--help</a></code>
+* <code title="cli">praisonai rules clear <a href="./src/praisonai/praisonai/cli/commands/rules.py">--help</a></code>
+* <code title="cli">praisonai rules list <a href="./src/praisonai/praisonai/cli/commands/rules.py">--help</a></code>
+* <code title="cli">praisonai run <a href="./src/praisonai/praisonai/cli/main.py">--help</a></code>
+* <code title="cli">praisonai run run-main <a href="./src/praisonai/praisonai/cli/commands/run.py">--help</a></code>
+* <code title="cli">praisonai schedule delete <a href="./src/praisonai/praisonai/cli/commands/schedule.py">--help</a></code>
+* <code title="cli">praisonai schedule describe <a href="./src/praisonai/praisonai/cli/commands/schedule.py">--help</a></code>
+* <code title="cli">praisonai schedule list <a href="./src/praisonai/praisonai/cli/commands/schedule.py">--help</a></code>
+* <code title="cli">praisonai schedule logs <a href="./src/praisonai/praisonai/cli/commands/schedule.py">--help</a></code>
+* <code title="cli">praisonai schedule restart <a href="./src/praisonai/praisonai/cli/commands/schedule.py">--help</a></code>
+* <code title="cli">praisonai schedule schedule-callback <a href="./src/praisonai/praisonai/cli/commands/schedule.py">--help</a></code>
+* <code title="cli">praisonai schedule start <a href="./src/praisonai/praisonai/cli/commands/schedule.py">--help</a></code>
+* <code title="cli">praisonai schedule stats <a href="./src/praisonai/praisonai/cli/commands/schedule.py">--help</a></code>
+* <code title="cli">praisonai schedule stop <a href="./src/praisonai/praisonai/cli/commands/schedule.py">--help</a></code>
+* <code title="cli">praisonai serve serve-callback <a href="./src/praisonai/praisonai/cli/commands/serve.py">--help</a></code>
+* <code title="cli">praisonai serve start <a href="./src/praisonai/praisonai/cli/commands/serve.py">--help</a></code>
+* <code title="cli">praisonai serve status <a href="./src/praisonai/praisonai/cli/commands/serve.py">--help</a></code>
+* <code title="cli">praisonai serve stop <a href="./src/praisonai/praisonai/cli/commands/serve.py">--help</a></code>
+* <code title="cli">praisonai session delete <a href="./src/praisonai/praisonai/cli/commands/session.py">--help</a></code>
+* <code title="cli">praisonai session export <a href="./src/praisonai/praisonai/cli/commands/session.py">--help</a></code>
+* <code title="cli">praisonai session import <a href="./src/praisonai/praisonai/cli/commands/session.py">--help</a></code>
+* <code title="cli">praisonai session list <a href="./src/praisonai/praisonai/cli/commands/session.py">--help</a></code>
+* <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>
+* <code title="cli">praisonai todo list <a href="./src/praisonai/praisonai/cli/commands/todo.py">--help</a></code>
+* <code title="cli">praisonai tools info <a href="./src/praisonai/praisonai/cli/commands/tools.py">--help</a></code>
+* <code title="cli">praisonai tools list <a href="./src/praisonai/praisonai/cli/commands/tools.py">--help</a></code>
+* <code title="cli">praisonai tools test <a href="./src/praisonai/praisonai/cli/commands/tools.py">--help</a></code>
+* <code title="cli">praisonai traces disable <a href="./src/praisonai/praisonai/cli/commands/traces.py">--help</a></code>
+* <code title="cli">praisonai traces enable <a href="./src/praisonai/praisonai/cli/commands/traces.py">--help</a></code>
+* <code title="cli">praisonai traces list <a href="./src/praisonai/praisonai/cli/commands/traces.py">--help</a></code>
+* <code title="cli">praisonai traces status <a href="./src/praisonai/praisonai/cli/commands/traces.py">--help</a></code>
+* <code title="cli">praisonai train train-main <a href="./src/praisonai/praisonai/cli/commands/train.py">--help</a></code>
+* <code title="cli">praisonai ui chat <a href="./src/praisonai/praisonai/cli/commands/ui.py">--help</a></code>
+* <code title="cli">praisonai ui code <a href="./src/praisonai/praisonai/cli/commands/ui.py">--help</a></code>
+* <code title="cli">praisonai ui gradio <a href="./src/praisonai/praisonai/cli/commands/ui.py">--help</a></code>
+* <code title="cli">praisonai ui realtime <a href="./src/praisonai/praisonai/cli/commands/ui.py">--help</a></code>
+* <code title="cli">praisonai ui ui-main <a href="./src/praisonai/praisonai/cli/commands/ui.py">--help</a></code>
+* <code title="cli">praisonai version check <a href="./src/praisonai/praisonai/cli/commands/version.py">--help</a></code>
+* <code title="cli">praisonai version show <a href="./src/praisonai/praisonai/cli/commands/version.py">--help</a></code>
+* <code title="cli">praisonai version version-callback <a href="./src/praisonai/praisonai/cli/commands/version.py">--help</a></code>
+* <code title="cli">praisonai workflow create <a href="./src/praisonai/praisonai/cli/commands/workflow.py">--help</a></code>
+* <code title="cli">praisonai workflow list <a href="./src/praisonai/praisonai/cli/commands/workflow.py">--help</a></code>
+* <code title="cli">praisonai workflow run <a href="./src/praisonai/praisonai/cli/commands/workflow.py">--help</a></code>
+
+# TypeScript
+
+Types/Exports:
+```ts
+export { Agent, Agents, PraisonAIAgents, Router } from "./agent";
+export type { PraisonAIAgentsConfig, SimpleAgentConfig, SimpleRouteConfig, SimpleRouterConfig } from "./agent";
+export { ContextAgent, createContextAgent } from "./agent/context";
+export { Handoff, handoff, handoffFilters } from "./agent/handoff";
+export { ImageAgent, createImageAgent } from "./agent/image";
+export { PromptExpanderAgent, createPromptExpanderAgent } from "./agent/prompt-expander";
+export { QueryRewriterAgent, createQueryRewriterAgent } from "./agent/query-rewriter";
+export { DeepResearchAgent, createDeepResearchAgent } from "./agent/research";
+export { RouterAgent, createRouter, routeConditions } from "./agent/router";
+export { // Agent loop
+  createAgentLoop, // DevTools
+  enableDevTools, // MCP
+  createMCP, // Middleware (renamed to avoid conflicts)
+  createCachingMiddleware, // Models
+  createModel, // Multimodal
+  createImagePart, // Next.js
+  createRouteHandler, // OAuth for MCP
+  type OAuthClientProvider, // Server adapters
+  createHttpHandler, // Speech & Transcription
+  generateSpeech, // Telemetry (AI SDK v6 parity)
+  configureTelemetry, // Tool Approval (AI SDK v6 parity)
+  ApprovalManager, // Tools
+  defineTool, // UI Message (AI SDK v6 parity)
+  convertToModelMessages, AIAgentStep, AIEmbedManyResult, AIEmbedOptions, AIEmbedResult, AIFilePart, AIGenerateImageOptions, AIGenerateImageResult, AIGenerateObjectOptions, AIGenerateObjectResult, AIGenerateTextOptions, AIGenerateTextResult, AIImagePart, AIMiddleware, AIMiddlewareConfig, AIModelMessage, AISpan, AISpanKind, AISpanOptions, AISpanStatus, AIStreamObjectOptions, AIStreamObjectResult, AIStreamTextOptions, AIStreamTextResult, AITelemetryEvent, AITelemetrySettings, AITextPart, AIToolDefinition, AITracer, AgentLoop, DANGEROUS_PATTERNS, MODEL_ALIASES, SPEECH_MODELS, TRANSCRIPTION_MODELS, ToolApprovalDeniedError, ToolApprovalTimeoutError, aiEmbed, aiEmbedMany, aiGenerateImage, aiGenerateObject, aiGenerateText, aiStreamObject, aiStreamText, applyMiddleware, autoEnableDevTools, base64ToUint8Array, clearAICache, clearEvents, closeAllMCPClients, closeMCPClient, convertToUIMessages, createAILoggingMiddleware, createAISpan, createApprovalResponse, createDangerousPatternChecker, createDevToolsMiddleware, createExpressHandler, createFastifyHandler, createFilePart, createHonoHandler, createMultimodalMessage, createNestHandler, createPagesHandler, createPdfPart, createSystemMessage, createTelemetryMiddleware, createTelemetrySettings, createTextMessage, createTextPart, createToolSet, disableAITelemetry, disableDevTools, enableAITelemetry, functionToTool, getAICacheStats, getApprovalManager, getDevToolsState, getDevToolsUrl, getEvents, getMCPClient, getModel, getTelemetrySettings, getToolsNeedingApproval, getTracer, hasModelAlias, hasPendingApprovals, initOpenTelemetry, isDangerous, isDataUrl, isDevToolsEnabled, isTelemetryEnabled, isUrl, listModelAliases, mcpToolsToAITools, parseModel, pipeUIMessageStreamToResponse, recordEvent, resolveModelAlias, safeValidateUIMessages, setApprovalManager, stopAfterSteps, stopWhen, stopWhenNoToolCalls, toMessageContent, toUIMessageStreamResponse, transcribe, uint8ArrayToBase64, validateUIMessages, withApproval, withSpan, wrapModel } from "./ai";
+export { AutoAgents, createAutoAgents } from "./auto";
+export { BaseCache, FileCache, MemoryCache, createFileCache, createMemoryCache } from "./cache";
+export { CLI_SPEC_VERSION, executeCommand, parseArgs } from "./cli";
+export { // Autonomy Mode
+  AutonomyManager, // Background Jobs
+  JobQueue, // Checkpoints
+  CheckpointManager, // Cost Tracker
+  CostTracker, // External Agents
+  BaseExternalAgent, // Fast Context
+  FastContext, // Flow Display
+  FlowDisplay, // Git Integration
+  GitManager, // Interactive TUI
+  InteractiveTUI, // N8N Integration
+  N8NIntegration, // Repo Map
+  RepoMap, // Sandbox Executor
+  SandboxExecutor, // Scheduler
+  Scheduler, // Slash Commands
+  SlashCommandHandler, AiderAgent, ClaudeCodeAgent, CodexCliAgent, CommandValidator, CostTokenUsage, DEFAULT_BLOCKED_COMMANDS, DEFAULT_BLOCKED_PATHS, DEFAULT_IGNORE_PATTERNS, DiffViewer, FileCheckpointStorage, FileJobStorage, GeminiCliAgent, GenericExternalAgent, HistoryManager, MODEL_PRICING, MODE_POLICIES, MemoryCheckpointStorage, MemoryJobStorage, StatusDisplay, cliApprovalPrompt, createAutonomyManager, createCheckpointManager, createCostTracker, createDiffViewer, createExternalAgent, createFastContext, createFileCheckpointStorage, createFileJobStorage, createFlowDisplay, createGitManager, createHistoryManager, createInteractiveTUI, createJobQueue, createN8NIntegration, createRepoMap, createSandboxExecutor, createScheduler, createSlashCommandHandler, createStatusDisplay, cronExpressions, estimateTokens, executeSlashCommand, externalAgentAsTool, formatCost, getExternalAgentRegistry, getQuickContext, getRepoTree, isSlashCommand, parseSlashCommand, registerCommand, renderWorkflow, sandboxExec, triggerN8NWebhook } from "./cli/features";
+export { createDbAdapter, db, getDefaultDbAdapter, setDefaultDbAdapter } from "./db";
+export type { DbAdapter, DbConfig, DbMessage, DbRun, DbTrace } from "./db";
+export { MemoryPostgresAdapter, NeonPostgresAdapter, PostgresSessionStorage, createMemoryPostgres, createNeonPostgres, createPostgresSessionStorage } from "./db/postgres";
+export { MemoryRedisAdapter, UpstashRedisAdapter, createMemoryRedis, createUpstashRedis } from "./db/redis";
+export { SQLiteAdapter, createSQLiteAdapter } from "./db/sqlite";
+export { EvalSuite, accuracyEval, performanceEval, reliabilityEval } from "./eval";
+export { AgentEventBus, AgentEvents, EventEmitterPubSub, PubSub, createEventBus, createPubSub } from "./events";
+export { LLMGuardrail, createLLMGuardrail } from "./guardrails/llm-guardrail";
+export { // Computer Use
+  createComputerUse, ComputerUseClient, createCLIApprovalPrompt, createComputerUseAgent } from "./integrations/computer-use";
+export { BaseObservabilityProvider, ConsoleObservabilityProvider, LangfuseObservabilityProvider, MemoryObservabilityProvider, ObservabilityTraceContext, createConsoleObservability, createLangfuseObservability, createMemoryObservability } from "./integrations/observability";
+export { // Natural Language Postgres
+  createNLPostgres, NLPostgresClient, NLPostgresConfig, createPostgresTool } from "./integrations/postgres";
+export { // Slack
+  createSlackBot, SlackBot, parseSlackMessage, verifySlackSignature } from "./integrations/slack";
+export { BaseVectorStore, ChromaVectorStore, MemoryVectorStore, PineconeVectorStore, QdrantVectorStore, VectorQueryResult, WeaviateVectorStore, createChromaStore, createMemoryVectorStore, createPineconeStore, createQdrantStore, createWeaviateStore } from "./integrations/vector";
+export { BaseVoiceProvider, ElevenLabsVoiceProvider, OpenAIVoiceProvider, createElevenLabsVoice, createOpenAIVoice } from "./integrations/voice";
+export { GraphRAG, GraphStore, createGraphRAG } from "./knowledge/graph-rag";
+export { BaseReranker, CohereReranker, CrossEncoderReranker, LLMReranker, createCohereReranker, createCrossEncoderReranker, createLLMReranker } from "./knowledge/reranker";
+export { // Provider classes
+  OpenAIProvider, // Provider factory and utilities
+  createProvider, // Provider registry (extensibility API)
+  ProviderRegistry, // Types
+  type LLMProvider, AnthropicProvider, BaseProvider, GoogleProvider, ProviderMessage, ProviderToolDefinition, createProviderRegistry, getAvailableProviders, getDefaultProvider, getDefaultRegistry, hasProvider, isProviderAvailable, listProviders, parseModelString, registerBuiltinProviders, registerProvider, unregisterProvider } from "./llm/providers";
+export { ADAPTERS, AISDK_PROVIDERS, COMMUNITY_PROVIDERS, PROVIDER_ALIASES } from "./llm/providers/ai-sdk/types";
+export { AutoMemory, AutoMemoryKnowledgeBase, AutoMemoryVectorStore, DEFAULT_POLICIES, createAutoMemory, createLLMSummarizer } from "./memory/auto-memory";
+export { FileMemory, createFileMemory } from "./memory/file-memory";
+export { Memory, createMemory } from "./memory/memory";
+export type { MemoryConfig, MemoryEntry } from "./memory/memory";
+export { // Adapters
+  NoopObservabilityAdapter, // Constants
+  OBSERVABILITY_TOOLS, // Global adapter management
+  setObservabilityAdapter, // Types
+  type SpanKind, ConsoleObservabilityAdapter, MemoryObservabilityAdapter, clearAdapterCache, createConsoleAdapter, createMemoryAdapter, createObservabilityAdapter, getObservabilityAdapter, getObservabilityToolInfo, hasObservabilityToolEnvVar, listObservabilityTools, noopAdapter, resetObservabilityAdapter, trace } from "./observability";
+export { Plan, PlanStep, PlanStorage, PlanningAgent, TaskAgent, TodoItem, TodoList, createPlan, createPlanStorage, createPlanningAgent, createTaskAgent, createTodoList } from "./planning";
+export { SkillManager, createSkillManager, parseSkillFile } from "./skills";
+export { AgentTelemetry, TelemetryCollector, cleanupTelemetry, createAgentTelemetry, disableTelemetry, enableTelemetry, getTelemetry } from "./telemetry";
+export { BaseTool, FunctionTool, ToolRegistry, ToolResult, ToolValidationError, createTool, getRegistry, getTool, registerTool, tool, validateTool } from "./tools";
+export { airweaveSearch, bedrockBrowserClick, bedrockBrowserFill, bedrockBrowserNavigate, bedrockCodeInterpreter, codeExecution, codeMode, createCustomTool, exaSearch, firecrawlCrawl, firecrawlScrape, parallelSearch, perplexitySearch, registerCustomTool, registerLocalTool, registerNpmTool, superagentGuard, superagentRedact, superagentVerify, tavilyCrawl, tavilyExtract, tavilySearch, valyuBioSearch, valyuCompanyResearch, valyuEconomicsSearch, valyuFinanceSearch, valyuPaperSearch, valyuPatentSearch, valyuSecSearch, valyuWebSearch } from "./tools/builtins";
+export { MissingDependencyError, MissingEnvVarError, ToolsRegistry, composeMiddleware, createLoggingMiddleware, createRateLimitMiddleware, createRedactionMiddleware, createRetryMiddleware, createTimeoutMiddleware, createToolsRegistry, createTracingMiddleware, createValidationMiddleware, getToolsRegistry, resetToolsRegistry } from "./tools/registry";
+export type { InstallHints, PraisonTool, RedactionHooks, RegisteredTool, ToolCapabilities, ToolExecutionContext, ToolExecutionResult, ToolFactory, ToolHooks, ToolInstallStatus, ToolLimits, ToolLogger, ToolMetadata, ToolMiddleware, ToolParameterProperty, ToolParameterSchema } from "./tools/registry";
+export { registerBuiltinTools, tools } from "./tools/tools";
+export { Workflow, loop, parallel, repeat, route } from "./workflows";
+export type { StepResult, WorkflowContext, WorkflowStep } from "./workflows";
+export { createWorkflowFromYAML, loadWorkflowFromFile, parseYAMLWorkflow, validateWorkflowDefinition } from "./workflows/yaml-parser";
+```
+
+# Optional Plugins
+
+External tools are available via `praisonai-tools` package:
+
+```bash
+pip install praisonai-tools
+```
+
+See [PraisonAI-tools](https://github.com/MervinPraison/PraisonAI-tools) for available tools.

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.6.2" \
+    "praisonai>=3.9.4" \
     "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.6.2" \
+    "praisonai>=3.9.4" \
     "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.6.2" \
+    "praisonai>=3.9.4" \
     "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/README.md

@@ -0,0 +1,96 @@
+# Consolidated Params Examples
+
+Examples demonstrating the **Agent-Centric API** with consolidated parameters.
+
+## Precedence Ladder
+
+```
+Instance > Config > Array > Dict > String > Bool > Default
+```
+
+## Quick Reference
+
+| Feature | Presets | Example |
+|---------|---------|---------|
+| `memory` | file, sqlite, redis, postgres, mem0, mongodb | `memory="sqlite"` |
+| `output` | minimal, normal, verbose, debug, silent | `output="verbose"` |
+| `execution` | fast, balanced, thorough, unlimited | `execution="balanced"` |
+| `planning` | reasoning, read_only, auto | `planning="reasoning"` |
+| `reflection` | minimal, standard, thorough | `reflection="standard"` |
+| `guardrails` | strict, permissive, safety | `guardrails="strict"` |
+| `web` | duckduckgo, tavily, google, bing, serper | `web="duckduckgo"` |
+| `context` | sliding_window, summarize, truncate | `context="sliding_window"` |
+| `autonomy` | suggest, auto_edit, full_auto | `autonomy="suggest"` |
+| `caching` | enabled, disabled, prompt | `caching="prompt"` |
+
+## Examples
+
+### Basic Examples (Single Feature)
+
+| File | Feature | Description |
+|------|---------|-------------|
+| `basic_agent.py` | Agent | Minimal agent with memory |
+| `basic_memory.py` | memory | SQLite memory preset |
+| `basic_output.py` | output | Verbose output preset |
+| `basic_execution.py` | execution | Execution control |
+| `basic_guardrails.py` | guardrails | Callable validator |
+| `basic_reflection.py` | reflection | Self-reflection preset |
+| `basic_web.py` | web | Web search preset |
+| `basic_planning.py` | planning | Planning preset |
+| `basic_autonomy.py` | autonomy | Autonomy preset |
+| `basic_caching.py` | caching | Caching preset |
+| `basic_knowledge.py` | knowledge | RAG with sources |
+| `basic_context.py` | context | Context management |
+| `basic_hooks.py` | hooks | Lifecycle callbacks |
+
+### Multi-Agent Examples
+
+| File | Description |
+|------|-------------|
+| `basic_agents.py` | Multi-agent with memory and planning |
+
+### Workflow Examples
+
+| File | Description |
+|------|-------------|
+| `basic_workflow.py` | Simple workflow with output preset |
+| `basic_workflow_agentlike.py` | Workflow with agent-like params |
+| `basic_step_override.py` | Step-level param overrides |
+| `advanced_workflow_full_features.py` | All consolidated params |
+
+### Advanced Examples
+
+| File | Description |
+|------|-------------|
+| `advanced_output_execution.py` | Combined output + execution |
+
+## Usage Forms
+
+Each consolidated param supports multiple input forms:
+
+```python
+# Bool - enable with defaults
+memory=True
+
+# String preset
+memory="sqlite"
+
+# Dict config
+memory={"backend": "sqlite", "user_id": "user123"}
+
+# Config instance
+memory=MemoryConfig(backend="sqlite", user_id="user123")
+
+# Array with overrides (for some params)
+guardrails=["strict", {"max_retries": 10}]
+```
+
+## Running Examples
+
+```bash
+# Set API key
+export OPENAI_API_KEY=your_key_here
+
+# Run any example
+python basic_agent.py
+```

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/consolidated_params/basic_autonomy.py

@@ -0,0 +1,18 @@
+"""
+Basic Autonomy Example - Agent-Centric API
+
+Demonstrates autonomy with consolidated params.
+Presets: suggest, auto_edit, full_auto
+"""
+
+from praisonaiagents import Agent
+
+# Basic: Enable autonomy with preset
+agent = Agent(
+    instructions="You are an autonomous assistant.",
+    autonomy="suggest",  # Presets: suggest, auto_edit, full_auto
+)
+
+if __name__ == "__main__":
+    response = agent.start("Help me organize my project files.")
+    print(response)

examples/consolidated_params/basic_caching.py

@@ -0,0 +1,23 @@
+"""
+Basic Caching Example - Agent-Centric API
+
+Demonstrates caching with consolidated params.
+Presets: enabled, disabled, prompt
+"""
+
+from praisonaiagents import Agent
+
+# Basic: Enable caching with preset
+agent = Agent(
+    instructions="You are a helpful assistant with caching enabled.",
+    caching="prompt",  # Presets: enabled, disabled, prompt
+)
+
+if __name__ == "__main__":
+    # First call - will cache
+    response = agent.start("What is the capital of France?")
+    print(response)
+    
+    # Second call - may use cache
+    response = agent.start("What is the capital of France?")
+    print(response)

examples/consolidated_params/basic_context.py

@@ -0,0 +1,18 @@
+"""
+Basic Context Example - Agent-Centric API
+
+Demonstrates context management with consolidated params.
+Presets: sliding_window, summarize, truncate
+"""
+
+from praisonaiagents import Agent
+
+# Basic: Enable context management with preset
+agent = Agent(
+    instructions="You are a helpful assistant with context management.",
+    context="sliding_window",  # Presets: sliding_window, summarize, truncate
+)
+
+if __name__ == "__main__":
+    response = agent.start("Tell me a long story about a dragon.")
+    print(response)

examples/consolidated_params/basic_hooks.py

@@ -0,0 +1,28 @@
+"""
+Basic Hooks Example - Agent-Centric API
+
+Demonstrates lifecycle hooks with consolidated params.
+Valid keys: on_step, on_tool_call, middleware
+"""
+
+from praisonaiagents import Agent
+
+# Define hook callbacks
+def on_step_callback(step_info):
+    print(f"Step: {step_info}")
+
+def on_tool_call_callback(tool_info):
+    print(f"Tool called: {tool_info}")
+
+# Basic: Enable hooks with dict
+agent = Agent(
+    instructions="You are a helpful assistant.",
+    hooks={
+        "on_step": on_step_callback,
+        "on_tool_call": on_tool_call_callback,
+    },
+)
+
+if __name__ == "__main__":
+    response = agent.start("What is 2 + 2?")
+    print(response)

examples/consolidated_params/basic_knowledge.py

@@ -0,0 +1,18 @@
+"""
+Basic Knowledge (RAG) Example - Agent-Centric API
+
+Demonstrates knowledge with consolidated params.
+Supports: bool, list of sources, dict config, KnowledgeConfig
+"""
+
+from praisonaiagents import Agent
+
+# Basic: Enable knowledge with list of sources
+agent = Agent(
+    instructions="You are a helpful assistant with document knowledge.",
+    knowledge=["docs/"],  # List of file/folder paths
+)
+
+if __name__ == "__main__":
+    response = agent.start("What does the documentation say about installation?")
+    print(response)

examples/consolidated_params/basic_planning.py

@@ -0,0 +1,18 @@
+"""
+Basic Planning Example - Agent-Centric API
+
+Demonstrates planning with consolidated params.
+Presets: reasoning, read_only, auto
+"""
+
+from praisonaiagents import Agent
+
+# Basic: Enable planning with preset
+agent = Agent(
+    instructions="You are a strategic planner.",
+    planning="reasoning",  # Presets: reasoning, read_only, auto
+)
+
+if __name__ == "__main__":
+    response = agent.start("Plan a 3-day trip to Tokyo.")
+    print(response)

examples/consolidated_params/basic_reflection.py

@@ -0,0 +1,18 @@
+"""
+Basic Reflection Example - Agent-Centric API
+
+Demonstrates reflection (self-reflect) with consolidated params.
+Presets: minimal, standard, thorough
+"""
+
+from praisonaiagents import Agent
+
+# Basic: Enable reflection with preset
+agent = Agent(
+    instructions="You are a helpful assistant that reflects on your answers.",
+    reflection="standard",  # Presets: minimal, standard, thorough
+)
+
+if __name__ == "__main__":
+    response = agent.start("Explain quantum computing in simple terms.")
+    print(response)

examples/consolidated_params/basic_web.py

@@ -0,0 +1,18 @@
+"""
+Basic Web Search Example - Agent-Centric API
+
+Demonstrates web search with consolidated params.
+Presets: duckduckgo, tavily, google, bing, serper, search_only, fetch_only
+"""
+
+from praisonaiagents import Agent
+
+# Basic: Enable web search with preset
+agent = Agent(
+    instructions="You are a research assistant with web access.",
+    web="duckduckgo",  # Presets: duckduckgo, tavily, google, bing, serper
+)
+
+if __name__ == "__main__":
+    response = agent.start("What are the latest AI developments in 2024?")
+    print(response)

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,18 @@
 #!/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.
 """
-
 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,28 +20,25 @@ 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."""
-    
     print("=== Agent Guardrail Examples ===\n")
     
     # Example 1: Function-based guardrail
@@ -52,10 +46,8 @@ def main():
     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")
@@ -67,10 +59,8 @@ def main():
     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
+        guardrails="Ensure the content is professional, formal, and suitable for business communication. No casual language or slang."
     )
-    
     try:
         result2 = agent2.start("Write a welcome message for new employees")
         print(f"Result: {result2}\n")
@@ -82,10 +72,8 @@ def main():
     agent3 = Agent(
         name="ProfessionalWriter",
         instructions="Write professional business content",
-        guardrail=validate_professional_tone,
-        max_guardrail_retries=2
+        guardrails=validate_professional_tone
     )
-    
     try:
         result3 = agent3.start("Write a casual greeting message")
         print(f"Result: {result3}\n")
@@ -94,5 +82,6 @@ def main():
     
     print("=== Agent Guardrails Demonstration Complete ===")
 
+
 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?")