Release v4.5.148

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.147" \
+    "praisonai>=4.5.148" \
     "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.147" \
+    "praisonai>=4.5.148" \
     "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.147" \
+    "praisonai>=4.5.148" \
     "praisonai[ui]" \
     "praisonai[crewai]"
 

examples/python/managed_agent_example.py

@@ -35,11 +35,10 @@ def example_1_standalone():
     print("Example 1: Standalone ManagedAgentIntegration")
     print("=" * 60)
 
-    from praisonai.integrations import ManagedAgentIntegration
-    from praisonaiagents import ManagedBackendConfig
+    from praisonai.integrations.managed_agents import ManagedAgent, ManagedConfig
 
-    managed = ManagedAgentIntegration(
-        config=ManagedBackendConfig(
+    managed = ManagedAgent(
+        config=ManagedConfig(
             model="claude-sonnet-4-6",
             name="Standalone Test Agent",
             system="You are a concise assistant. Answer in one sentence.",
@@ -60,11 +59,11 @@ def example_2_with_agent():
     print("Example 2: PraisonAI Agent with managed backend")
     print("=" * 60)
 
-    from praisonaiagents import Agent, ManagedBackendConfig
-    from praisonai.integrations import ManagedAgentIntegration
+    from praisonaiagents import Agent
+    from praisonai.integrations.managed_agents import ManagedAgent, ManagedConfig
 
-    managed = ManagedAgentIntegration(
-        config=ManagedBackendConfig(
+    managed = ManagedAgent(
+        config=ManagedConfig(
             model="claude-sonnet-4-6",
             name="PraisonAI Backend Agent",
             system="You are a helpful coding assistant. Be concise.",
@@ -90,11 +89,11 @@ def example_3_with_tools():
     print("Example 3: Managed agent with built-in tools")
     print("=" * 60)
 
-    from praisonaiagents import Agent, ManagedBackendConfig
-    from praisonai.integrations import ManagedAgentIntegration
+    from praisonaiagents import Agent
+    from praisonai.integrations.managed_agents import ManagedAgent, ManagedConfig
 
-    managed = ManagedAgentIntegration(
-        config=ManagedBackendConfig(
+    managed = ManagedAgent(
+        config=ManagedConfig(
             model="claude-sonnet-4-6",
             name="Tool-Using Agent",
             system="You are a coding agent with access to bash and file tools.",
@@ -123,11 +122,11 @@ def example_4_with_packages():
     print("Example 4: Managed agent with pip packages")
     print("=" * 60)
 
-    from praisonaiagents import Agent, ManagedBackendConfig
-    from praisonai.integrations import ManagedAgentIntegration
+    from praisonaiagents import Agent
+    from praisonai.integrations.managed_agents import ManagedAgent, ManagedConfig
 
-    managed = ManagedAgentIntegration(
-        config=ManagedBackendConfig(
+    managed = ManagedAgent(
+        config=ManagedConfig(
             model="claude-sonnet-4-6",
             name="Data Agent",
             system="You are a data analysis agent. Use pandas when helpful.",

examples/terminal_bench/praisonai_external_agent.py

@@ -121,24 +121,22 @@ async def bash_tool(command: str) -> str:
             agent = Agent(
                 name="terminal-agent",
                 instructions=(
-                    "You are an expert terminal agent working on coding, security, and system administration tasks. "
-                    "Use the bash_tool to execute shell commands in the sandboxed environment. "
+                    "You are an expert terminal agent. You solve coding, debugging, data analysis, security, "
+                    "and system administration tasks using the bash_tool to run shell commands."
                     "\n\nCRITICAL RULES:"
-                    "\n1. ALWAYS start by reading ALL relevant files: "
-                    "   ls /app/ && ls /tests/ 2>/dev/null && cat /app/*.py 2>/dev/null && cat /tests/*.py 2>/dev/null || true"
-                    "   Read EVERY source file including the test/verifier scripts to understand exactly what passes."
-                    "\n2. Run the test IMMEDIATELY after reading files to see the current failure message: "
-                    "   cd /app && python3 -m pytest /app/test_outputs.py -v 2>&1 | tail -50 || true"
-                    "   The error trace tells you EXACTLY what the test expects."
-                    "\n3. For writing files with special characters (quotes, backslashes, parentheses), "
-                    "   ALWAYS use Python: python3 -c \"with open('/app/out.html','w') as f: f.write('...')\""
-                    "\n4. ITERATE: Try an approach, run the test, read the error, try again. Keep going until the test passes."
-                    "   Never give up after one attempt — try multiple different approaches."
-                    "\n5. Read error messages carefully — they tell you exactly what to fix next."
-                    "\n6. If the task involves bypassing/exploiting/breaking something: "
-                    "   experiment with many different payloads, test each one, and use the test output to guide you."
-                    "\n7. NEVER stop to describe or explain what you plan to do. ALWAYS immediately call "
-                    "   bash_tool to execute commands. Keep using bash_tool until the test PASSES."
+                    "\n1. START by exploring: ls /app/ && cat /app/*.py /app/*.sh /app/*.txt 2>/dev/null | head -200"
+                    "   Read ALL task files to understand what is needed before doing anything."
+                    "\n2. Find and run the test IMMEDIATELY to see what is expected:"
+                    "   find /app -name 'test_*.py' | head -3 && cd /app && python3 -m pytest -v 2>&1 | tail -40 || true"
+                    "   The test error trace tells you EXACTLY what output/behavior is required."
+                    "\n3. ITERATE: implement a solution, run the test, read the error, refine. Repeat until it passes."
+                    "   Never give up after one attempt — try multiple approaches if needed."
+                    "\n4. For writing files with special characters use Python:"
+                    "   python3 -c \"with open('/app/file','w') as f: f.write('content')\""
+                    "   or heredoc: cat > /app/file << 'EOF'\\n...content...\\nEOF"
+                    "\n5. Read ALL error messages — they tell you exactly what to fix next."
+                    "\n6. NEVER just describe your plan. ALWAYS immediately run bash_tool commands."
+                    "   Keep calling bash_tool until the test PASSES or you have exhausted all approaches."
                 ),
                 tools=[bash_tool],
                 llm=self.model_name or "openai/gpt-4o",
@@ -149,17 +147,17 @@ async def bash_tool(command: str) -> str:
             result = await agent.achat(instruction)
             for _iter in range(19):
                 result_str = str(result)
-                # Stop if test passed or we have clear completion
+                # Stop if test passed
                 if any(sig in result_str.lower() for sig in [
-                    "passed", "1 passed", "test passed", "all tests"
+                    " passed", "passed ", "test passed", "all tests pass", "1 passed"
                 ]):
                     break
                 result = await agent.achat(
-                    "The task is NOT complete yet. You must keep working. "
-                    "Run bash_tool commands now — do not explain, just act. "
-                    "If you have not yet created /app/out.html, create it now with a JS payload that bypasses the filter. "
-                    "Then run: python3 /app/test_outputs.py to check if it passes. "
-                    "Keep iterating until the test passes."
+                    "The task is NOT complete yet — keep working. Run bash_tool commands now. "
+                    "If you haven't already: (1) read all files in /app/, "
+                    "(2) run the test to see the exact failure, "
+                    "(3) implement a fix, (4) run the test again. "
+                    "Repeat until the test passes. What is your next bash_tool command?"
                 )
             print(f"✅ PraisonAI Agent completed task")
 

src/praisonai-agents/praisonaiagents/__init__.py

@@ -456,9 +456,8 @@ def _get_lazy_cache():
     'SandboxConfig': ('praisonaiagents.sandbox.config', 'SandboxConfig'),
     'SecurityPolicy': ('praisonaiagents.sandbox.config', 'SecurityPolicy'),
 
-    # Managed backend protocols (implementations in praisonai wrapper)
+    # Managed backend protocol (implementation + config in praisonai wrapper)
     'ManagedBackendProtocol': ('praisonaiagents.agent.protocols', 'ManagedBackendProtocol'),
-    'ManagedBackendConfig': ('praisonaiagents.agent.protocols', 'ManagedBackendConfig'),
 
     # Model failover
     'AuthProfile': ('praisonaiagents.llm.failover', 'AuthProfile'),

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

@@ -279,7 +279,12 @@ def run(self, prompt: str, **kwargs: Any) -> Optional[str]:
         return result
 
     def _delegate_to_backend(self, prompt: str, **kwargs) -> Optional[str]:
-        """Delegate execution to external managed backend (e.g., ManagedAgentIntegration)."""
+        """Delegate execution to external managed backend (e.g., ManagedAgentIntegration).
+        
+        Also records the prompt and response in the Agent's chat_history so that
+        PraisonAI's session management (SessionStore, auto_save) stays consistent
+        with managed-backend conversations.
+        """
         import asyncio
 
         # Check if backend satisfies ManagedBackendProtocol
@@ -291,15 +296,31 @@ def _delegate_to_backend(self, prompt: str, **kwargs) -> Optional[str]:
         stream_requested = kwargs.get('stream', False)
 
         if stream_requested:
-            # For streaming, delegate to backend's stream method if available
             if hasattr(self.backend, 'stream'):
-                return self._delegate_streaming_to_backend(prompt, **kwargs)
+                result = self._delegate_streaming_to_backend(prompt, **kwargs)
             else:
-                # Fallback: execute non-streaming even if stream was requested
-                return self._execute_backend_sync(prompt, **kwargs)
+                result = self._execute_backend_sync(prompt, **kwargs)
         else:
-            # Non-streaming execution
-            return self._execute_backend_sync(prompt, **kwargs)
+            result = self._execute_backend_sync(prompt, **kwargs)
+        
+        # ── Chat history & session linkage ──
+        # Record prompt+response in chat_history so SessionStore/auto_save works
+        if result is not None and not stream_requested:
+            self.chat_history.append({"role": "user", "content": prompt})
+            self.chat_history.append({"role": "assistant", "content": str(result)})
+            # Link managed session ID into SessionStore gateway_session_id
+            if hasattr(self.backend, 'managed_session_id'):
+                msid = self.backend.managed_session_id
+                if msid and self._session_store is not None:
+                    try:
+                        sid = getattr(self, 'auto_save', None) or getattr(self, '_session_id', None)
+                        if sid and hasattr(self._session_store, 'set_gateway_info'):
+                            self._session_store.set_gateway_info(sid, gateway_session_id=msid)
+                    except Exception:
+                        pass  # Best-effort linkage
+            self._auto_save_session()
+        
+        return result
 
     def _execute_backend_sync(self, prompt: str, **kwargs) -> Optional[str]:
         """Execute backend in sync mode, handling async backends."""

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

@@ -10,7 +10,6 @@
 These protocols are lightweight and have zero performance impact.
 """
 from typing import Protocol, runtime_checkable, Optional, Any, AsyncIterator, Dict, List
-from dataclasses import dataclass, field
 
 
 @runtime_checkable
@@ -303,44 +302,6 @@ def launch(
         ...
 
 
-@dataclass
-class ManagedBackendConfig:
-    """Configuration for managed agent backends.
-    
-    Portable dataclass that describes *what* to create on the managed
-    infrastructure without tying to any provider SDK.
-    
-    Example::
-    
-        cfg = ManagedBackendConfig(
-            model="claude-sonnet-4-6",
-            system="You are a coding assistant.",
-            tools=[{"type": "agent_toolset_20260401"}],
-            packages={"pip": ["pandas", "numpy"]},
-            networking={"type": "unrestricted"},
-        )
-    """
-    # ── Agent fields ──
-    name: str = "PraisonAI Managed Agent"
-    model: str = "claude-sonnet-4-6"
-    system: str = "You are a helpful AI assistant."
-    tools: List[Dict[str, Any]] = field(default_factory=lambda: [{"type": "agent_toolset_20260401"}])
-    mcp_servers: List[Dict[str, Any]] = field(default_factory=list)
-    skills: List[Dict[str, Any]] = field(default_factory=list)
-    callable_agents: List[Dict[str, Any]] = field(default_factory=list)
-    metadata: Dict[str, Any] = field(default_factory=dict)
-    
-    # ── Environment fields ──
-    env_name: str = "praisonai-env"
-    packages: Optional[Dict[str, List[str]]] = None
-    networking: Dict[str, Any] = field(default_factory=lambda: {"type": "unrestricted"})
-    
-    # ── Session fields ──
-    session_title: str = "PraisonAI session"
-    resources: List[Dict[str, Any]] = field(default_factory=list)
-    vault_ids: List[str] = field(default_factory=list)
-
-
 @runtime_checkable
 class ManagedBackendProtocol(Protocol):
     """Protocol for external managed agent backends.
@@ -354,7 +315,7 @@ class ManagedBackendProtocol(Protocol):
     
     Lifecycle::
     
-        backend = SomeManagedBackend(config=ManagedBackendConfig(...))
+        backend = SomeManagedBackend(config={...})
         agent = Agent(name="coder", backend=backend)
         result = agent.start("Write a script")  # delegates to backend.execute()
     
@@ -429,6 +390,46 @@ def reset_all(self) -> None:
         """
         ...
 
+    # ── Optional methods (default no-ops for backward compat) ──
+
+    def update_agent(self, **kwargs) -> None:
+        """Update an existing managed agent's configuration.
+        
+        Allows changing system prompt, tools, model, etc. on a previously
+        created agent without recreating it.
+        
+        Args:
+            **kwargs: Fields to update (system, tools, model, name, etc.).
+        """
+        ...
+
+    def interrupt(self) -> None:
+        """Send a user interrupt to the active session.
+        
+        Signals the managed agent to stop its current work (equivalent to
+        ``user.interrupt`` event in the Anthropic API).
+        """
+        ...
+
+    def retrieve_session(self) -> Dict[str, Any]:
+        """Retrieve the current managed session's metadata and usage.
+        
+        Returns:
+            Dict with session info (id, status, usage, etc.).
+        """
+        ...
+
+    def list_sessions(self, **kwargs) -> List[Dict[str, Any]]:
+        """List sessions for the current agent.
+        
+        Args:
+            **kwargs: Provider-specific filters (limit, status, etc.).
+            
+        Returns:
+            List of session summary dicts.
+        """
+        ...
+
 
 __all__ = [
     'AgentProtocol',
@@ -440,5 +441,4 @@ def reset_all(self) -> None:
     'HttpLauncherProtocol',
     'McpLauncherProtocol',
     'ManagedBackendProtocol',
-    'ManagedBackendConfig',
 ]

src/praisonai-agents/pyproject.toml

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