Release v4.5.1

Author: MervinPraison

docker/Dockerfile.chat

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

docker/Dockerfile.dev

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

docker/Dockerfile.ui

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

src/praisonai-agents/AGENTS.md

@@ -344,6 +344,56 @@ agent = Agent(
 )
 ```
 
+### 5.3 Parameter Consolidation
+
+Agent parameters are consolidated into Config objects following the pattern:
+`False=disabled, True=defaults, Config=custom`
+
+**Consolidated Parameters (use these):**
+
+| Config Object | Replaces (Deprecated) |
+|--------------|----------------------|
+| `execution=ExecutionConfig(code_execution=True, code_mode="safe", rate_limiter=obj)` | `allow_code_execution`, `code_execution_mode`, `rate_limiter` |
+| `memory=MemoryConfig(auto_save="session_name")` | `auto_save` |
+| `autonomy=AutonomyConfig(verification_hooks=[...])` | `verification_hooks` |
+| `handoffs=[other_agent]` | `allow_delegation` |
+| `output=OutputConfig(...)` | `verbose`, `markdown`, `stream`, `metrics` |
+| `reflection=ReflectionConfig(...)` | `self_reflect`, `max_reflect`, `min_reflect` |
+| `templates=TemplateConfig(...)` | `system_template`, `prompt_template`, `response_template` |
+| `caching=CachingConfig(...)` | `cache`, `prompt_caching` |
+| `web=WebConfig(...)` | `web_search`, `web_fetch` |
+
+**Deprecated standalone params still work** (backward compatible) but emit `DeprecationWarning`.
+
+```python
+# ❌ Old way (deprecated)
+agent = Agent(
+    name="coder",
+    allow_code_execution=True,
+    code_execution_mode="safe",
+    auto_save="my_session",
+    rate_limiter=my_limiter,
+    allow_delegation=True,
+    verification_hooks=[my_hook],
+)
+
+# ✅ New way (consolidated)
+from praisonaiagents import Agent, ExecutionConfig, MemoryConfig
+from praisonaiagents.agent.autonomy import AutonomyConfig
+
+agent = Agent(
+    name="coder",
+    handoffs=[reviewer_agent],
+    execution=ExecutionConfig(
+        code_execution=True,
+        code_mode="safe",
+        rate_limiter=my_limiter,
+    ),
+    memory=MemoryConfig(auto_save="my_session"),
+    autonomy=AutonomyConfig(verification_hooks=[my_hook]),
+)
+```
+
 ---
 
 ## 6. Extension Points

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

@@ -411,13 +411,13 @@ def __init__(
         api_key: Optional[str] = None,  # Kept separate (connection/auth)
         # Tools
         tools: Optional[List[Any]] = None,
-        allow_delegation: bool = False,
-        allow_code_execution: Optional[bool] = False,
-        code_execution_mode: Literal["safe", "unsafe"] = "safe",
+        allow_delegation: bool = False,  # Deprecated: use handoffs= instead
+        allow_code_execution: Optional[bool] = False,  # Deprecated: use execution=ExecutionConfig(code_execution=True)
+        code_execution_mode: Literal["safe", "unsafe"] = "safe",  # Deprecated: use execution=ExecutionConfig(code_mode="safe")
         handoffs: Optional[List[Union['Agent', 'Handoff']]] = None,
-        # Session management
-        auto_save: Optional[str] = None,
-        rate_limiter: Optional[Any] = None,
+        # Session management (deprecated standalone params - use config objects)
+        auto_save: Optional[str] = None,  # Deprecated: use memory=MemoryConfig(auto_save="name")
+        rate_limiter: Optional[Any] = None,  # Deprecated: use execution=ExecutionConfig(rate_limiter=obj)
         # ============================================================
         # CONSOLIDATED FEATURE PARAMS (agent-centric API)
         # Each follows: False=disabled, True=defaults, Config=custom
@@ -430,7 +430,7 @@ def __init__(
         web: Optional[Union[bool, Any]] = None,  # Union[bool, WebConfig]
         context: Optional[Union[bool, Any]] = None,  # Union[bool, ManagerConfig, ContextManager] - None=smart default
         autonomy: Optional[Union[bool, Dict[str, Any], Any]] = None,  # Union[bool, dict, AutonomyConfig]
-        verification_hooks: Optional[List[Any]] = None,  # List of VerificationHook instances
+        verification_hooks: Optional[List[Any]] = None,  # Deprecated: use autonomy=AutonomyConfig(verification_hooks=[...])
         output: Optional[Union[str, Any]] = None,  # Union[str preset, OutputConfig]
         execution: Optional[Union[str, Any]] = None,  # Union[str preset, ExecutionConfig]
         templates: Optional[Any] = None,  # TemplateConfig
@@ -453,12 +453,12 @@ def __init__(
             base_url: Custom LLM endpoint URL (e.g., for Ollama). Kept separate for auth.
             api_key: API key for LLM provider. Kept separate for auth.
             tools: List of tools, functions, callables, or MCP instances.
-            allow_delegation: Allow task delegation to other agents. Defaults to False.
-            allow_code_execution: Enable code execution during tasks. Defaults to False.
-            code_execution_mode: "safe" (restricted) or "unsafe" (full access). Defaults to "safe".
+            allow_delegation: **Deprecated** — use ``handoffs=`` instead.
+            allow_code_execution: **Deprecated** — use ``execution=ExecutionConfig(code_execution=True)``.
+            code_execution_mode: **Deprecated** — use ``execution=ExecutionConfig(code_mode="safe")``.
             handoffs: List of Agent or Handoff objects for agent-to-agent collaboration.
-            auto_save: Session name for automatic session saving.
-            rate_limiter: Rate limiter instance for API call throttling.
+            auto_save: **Deprecated** — use ``memory=MemoryConfig(auto_save="name")``.
+            rate_limiter: **Deprecated** — use ``execution=ExecutionConfig(rate_limiter=obj)``.
             memory: Memory system configuration. Accepts:
                 - bool: True enables defaults, False disables
                 - MemoryConfig: Custom configuration
@@ -487,7 +487,8 @@ def __init__(
                 - bool: True enables with defaults
                 - Dict: Configuration dict
                 - AutonomyConfig: Custom configuration
-            verification_hooks: List of VerificationHook instances for output verification.
+            verification_hooks: **Deprecated** — use ``autonomy=AutonomyConfig(verification_hooks=[...])``.
+                Still works for backward compatibility.
             output: Output configuration. Accepts:
                 - str: Preset name ("silent", "actions", "verbose", "json", "stream")
                 - OutputConfig: Custom configuration
@@ -521,6 +522,11 @@ def __init__(
             - system_template, prompt_template, response_template → templates=
             - cache, prompt_caching → caching=
             - web_search, web_fetch → web=
+            - allow_delegation → handoffs=
+            - allow_code_execution, code_execution_mode → execution=
+            - auto_save → memory=MemoryConfig(auto_save=)
+            - rate_limiter → execution=ExecutionConfig(rate_limiter=)
+            - verification_hooks → autonomy=AutonomyConfig(verification_hooks=)
         """
         # Add check at start if memory is requested
         if memory is not None:
@@ -585,6 +591,48 @@ def __init__(
             # AutonomyConfig is in agent/autonomy.py - use dict for config defaults
             autonomy = apply_config_defaults("autonomy", autonomy, None)
 
+        # ============================================================
+        # DEPRECATION WARNINGS for params consolidated into configs
+        # Old params still work but emit warnings pointing to new API
+        # ============================================================
+        import warnings as _warnings
+        
+        if allow_delegation:
+            _warnings.warn(
+                "Parameter 'allow_delegation' is deprecated. Use 'handoffs=[other_agent]' instead.",
+                DeprecationWarning, stacklevel=2,
+            )
+        if allow_code_execution:
+            _warnings.warn(
+                "Parameter 'allow_code_execution' is deprecated. "
+                "Use 'execution=ExecutionConfig(code_execution=True)' instead.",
+                DeprecationWarning, stacklevel=2,
+            )
+        if code_execution_mode != "safe":
+            _warnings.warn(
+                "Parameter 'code_execution_mode' is deprecated. "
+                "Use 'execution=ExecutionConfig(code_mode=\"unsafe\")' instead.",
+                DeprecationWarning, stacklevel=2,
+            )
+        if auto_save is not None:
+            _warnings.warn(
+                "Parameter 'auto_save' is deprecated. "
+                "Use 'memory=MemoryConfig(auto_save=\"name\")' instead.",
+                DeprecationWarning, stacklevel=2,
+            )
+        if rate_limiter is not None:
+            _warnings.warn(
+                "Parameter 'rate_limiter' is deprecated. "
+                "Use 'execution=ExecutionConfig(rate_limiter=obj)' instead.",
+                DeprecationWarning, stacklevel=2,
+            )
+        if verification_hooks is not None:
+            _warnings.warn(
+                "Parameter 'verification_hooks' is deprecated. "
+                "Use 'autonomy=AutonomyConfig(verification_hooks=[...])' instead.",
+                DeprecationWarning, stacklevel=2,
+            )
+
         # ============================================================
         # CONSOLIDATED PARAMS EXTRACTION (agent-centric API)
         # Uses unified resolver: Instance > Config > Array > String > Bool > Default
@@ -731,6 +779,13 @@ def __init__(
             max_rpm = _exec_config.max_rpm
             max_execution_time = _exec_config.max_execution_time
             max_retry_limit = _exec_config.max_retry_limit
+            # Extract consolidated fields (config takes precedence over deprecated standalone params)
+            if _exec_config.rate_limiter is not None:
+                rate_limiter = _exec_config.rate_limiter
+            if _exec_config.code_execution:
+                allow_code_execution = True
+            if _exec_config.code_mode != "safe":
+                code_execution_mode = _exec_config.code_mode
         else:
             max_iter, max_rpm, max_execution_time, max_retry_limit = 20, None, None, 2
 
@@ -880,6 +935,9 @@ def __init__(
                 db = _memory_config.db
                 auto_memory = _memory_config.auto_memory
                 claude_memory = _memory_config.claude_memory
+                # Extract auto_save from MemoryConfig (takes precedence over standalone param)
+                if _memory_config.auto_save is not None:
+                    auto_save = _memory_config.auto_save
                 # Convert to internal format
                 backend = _memory_config.backend
                 if hasattr(backend, 'value'):
@@ -1846,6 +1904,9 @@ def _init_autonomy(self, autonomy: Any, verification_hooks: Optional[List[Any]]
                 "auto_escalate": autonomy.auto_escalate,
             }
             config = autonomy
+            # Extract verification_hooks from AutonomyConfig if provided
+            if autonomy.verification_hooks and not verification_hooks:
+                self._verification_hooks = autonomy.verification_hooks
         else:
             self.autonomy_enabled = False
             self.autonomy_config = {}

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

@@ -55,6 +55,7 @@ class AutonomyConfig:
         observe: Whether to emit observability events
         completion_promise: Optional string that signals completion when wrapped in <promise>TEXT</promise>
         clear_context: Whether to clear chat history between iterations
+        verification_hooks: List of VerificationHook instances for output verification
     """
     enabled: bool = True
     max_iterations: int = 20
@@ -63,6 +64,7 @@ class AutonomyConfig:
     observe: bool = False
     completion_promise: Optional[str] = None
     clear_context: bool = False
+    verification_hooks: Optional[List[Any]] = None
 
     @classmethod
     def from_dict(cls, data: Dict[str, Any]) -> "AutonomyConfig":
@@ -75,6 +77,7 @@ def from_dict(cls, data: Dict[str, Any]) -> "AutonomyConfig":
             observe=data.get("observe", False),
             completion_promise=data.get("completion_promise"),
             clear_context=data.get("clear_context", False),
+            verification_hooks=data.get("verification_hooks"),
         )
 
 

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

@@ -462,25 +462,31 @@ def _create_agents_and_tasks(self, config: AutoAgentsConfig) -> Tuple[List[Agent
             # Use consolidated knowledge if provided, else fall back to legacy knowledge_sources
             effective_knowledge = self._knowledge if self._knowledge is not None else self.knowledge_sources
 
+            # Build execution config merging legacy code_execution params
+            _effective_execution = self._execution
+            if _effective_execution is None and (self.allow_code_execution or self.code_execution_mode != "safe"):
+                from ..config.feature_configs import ExecutionConfig
+                _effective_execution = ExecutionConfig(
+                    code_execution=bool(self.allow_code_execution),
+                    code_mode=self.code_execution_mode,
+                )
+            
             agent = Agent(
                 name=agent_config.name,
                 role=agent_config.role,
                 goal=agent_config.goal,
                 backstory=agent_config.backstory,
                 tools=agent_tools,  # Use assigned tools
-                allow_code_execution=self.allow_code_execution,
                 memory=self.memory,
                 llm=self.llm,  # Consolidated LLM param
-                code_execution_mode=self.code_execution_mode,
-                allow_delegation=self.allow_delegation,
                 base_url=self.base_url,
                 api_key=self.api_key,
                 # Consolidated params (new SDK contract)
                 output=self._output,  # Overrides verbose/markdown
                 reflection=self._reflection,  # Overrides self_reflect/max_reflect/min_reflect/reflect_llm
                 caching=self._caching,  # Overrides cache
                 knowledge=effective_knowledge,  # Overrides knowledge_sources/embedder_config
-                execution=self._execution,  # Overrides max_iter
+                execution=_effective_execution,  # Overrides max_iter + code execution
                 guardrails=self._guardrails,
                 web=self._web,
                 hooks=self._hooks,

src/praisonai-agents/praisonaiagents/config/feature_configs.py

@@ -172,6 +172,10 @@ class MemoryConfig:
     history: bool = False
     history_limit: int = 10
 
+    # Auto-save session name (consolidated from standalone auto_save param)
+    # When set, automatically saves session to memory with this name
+    auto_save: Optional[str] = None
+    
     def to_dict(self) -> Dict[str, Any]:
         """Convert to dictionary."""
         learn_dict = None
@@ -193,6 +197,7 @@ def to_dict(self) -> Dict[str, Any]:
             "learn": learn_dict,
             "history": self.history,
             "history_limit": self.history_limit,
+            "auto_save": self.auto_save,
         }
 
 
@@ -609,7 +614,8 @@ class ExecutionConfig:
     """
     Configuration for agent execution limits.
     
-    Consolidates: max_iter, max_rpm, max_execution_time, max_retry_limit
+    Consolidates: max_iter, max_rpm, max_execution_time, max_retry_limit,
+                  allow_code_execution, code_execution_mode, rate_limiter
     
     Usage:
         # Simple preset
@@ -622,6 +628,13 @@ class ExecutionConfig:
             max_execution_time=300,
             max_retry_limit=5,
         ))
+        
+        # With code execution and rate limiter
+        Agent(execution=ExecutionConfig(
+            code_execution=True,
+            code_mode="safe",
+            rate_limiter=my_limiter,
+        ))
     """
     # Iteration limits
     max_iter: int = 20
@@ -635,13 +648,22 @@ class ExecutionConfig:
     # Retry settings
     max_retry_limit: int = 2
 
+    # Code execution (consolidated from allow_code_execution + code_execution_mode)
+    code_execution: bool = False
+    code_mode: str = "safe"  # "safe" or "unsafe"
+    
+    # Rate limiter instance (consolidated from standalone rate_limiter param)
+    rate_limiter: Optional[Any] = None
+    
     def to_dict(self) -> Dict[str, Any]:
         """Convert to dictionary."""
         return {
             "max_iter": self.max_iter,
             "max_rpm": self.max_rpm,
             "max_execution_time": self.max_execution_time,
             "max_retry_limit": self.max_retry_limit,
+            "code_execution": self.code_execution,
+            "code_mode": self.code_mode,
         }
 
 

src/praisonai-agents/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "praisonaiagents"
-version = "1.5.0"
+version = "1.5.1"
 description = "Praison AI agents for completing complex tasks with Self Reflection Agents"
 readme = "README.md"
 requires-python = ">=3.10"