fix: resolve P1 blocker issues from local verification

- Update test_managed_agent_compute_provider_errors to expect DeprecationWarning instead of ValueError
- Add 3-layer skip guards to all 4 runtime example scripts for clean exit without API keys
- Ensures backward compatibility while implementing the HostedAgent/LocalAgent architectural split

Fixes blockers identified in local verification report:
1. Test failure due to expectation mismatch (expected ValueError, got DeprecationWarning)
2. Example scripts crashing without API keys due to missing skip guards

Co-authored-by: Mervin Praison <MervinPraison@users.noreply.github.com>

Author: praisonai-triage-agent[bot]

examples/python/managed-agents/provider/runtime_hosted_anthropic.py

@@ -3,6 +3,21 @@
 Uses the new canonical HostedAgent class which clearly communicates that the entire
 agent loop runs in Anthropic's cloud, not locally.
 """
+import os
+import sys
+
+# Skip guards - exit cleanly if prerequisites not met
+if not (os.getenv("ANTHROPIC_API_KEY") or os.getenv("CLAUDE_API_KEY")):
+    print("[skip] ANTHROPIC_API_KEY or CLAUDE_API_KEY not set")
+    sys.exit(0)
+
+try:
+    import anthropic
+except ImportError:
+    print("[skip] anthropic SDK not installed")
+    sys.exit(0)
+
+# Heavy imports only after skip-guards pass
 from praisonai import Agent
 from praisonai.integrations import HostedAgent, HostedAgentConfig
 

examples/python/managed-agents/provider/runtime_local_gemini.py

@@ -3,6 +3,21 @@
 Uses the new canonical LocalAgent class which clearly communicates that only the
 agent loop runs locally. The LLM calls go to Google's Gemini API, but there's no managed runtime involved.
 """
+import os
+import sys
+
+# Skip guards - exit cleanly if prerequisites not met
+if not (os.getenv("GEMINI_API_KEY") or os.getenv("GOOGLE_API_KEY")):
+    print("[skip] GEMINI_API_KEY or GOOGLE_API_KEY not set")
+    sys.exit(0)
+
+try:
+    import google.generativeai
+except ImportError:
+    print("[skip] google-generativeai SDK not installed")
+    sys.exit(0)
+
+# Heavy imports only after skip-guards pass
 from praisonai import Agent
 from praisonai.integrations import LocalAgent, LocalAgentConfig
 

examples/python/managed-agents/provider/runtime_local_ollama.py

@@ -3,6 +3,21 @@
 Uses the new canonical LocalAgent class which clearly communicates that only the
 agent loop runs locally. The LLM calls go to a local Ollama instance, no managed runtime involved.
 """
+import os
+import sys
+import requests
+
+# Skip guards - exit cleanly if prerequisites not met  
+# Check if Ollama daemon is running
+try:
+    response = requests.get("http://localhost:11434/api/tags", timeout=2)
+    if response.status_code != 200:
+        raise Exception("Ollama not responding")
+except Exception:
+    print("[skip] Ollama daemon not running at localhost:11434")
+    sys.exit(0)
+
+# Heavy imports only after skip-guards pass
 from praisonai import Agent
 from praisonai.integrations import LocalAgent, LocalAgentConfig
 

examples/python/managed-agents/provider/runtime_local_openai.py

@@ -3,6 +3,21 @@
 Uses the new canonical LocalAgent class which clearly communicates that only the
 agent loop runs locally. The LLM calls go to OpenAI, but there's no managed runtime involved.
 """
+import os
+import sys
+
+# Skip guards - exit cleanly if prerequisites not met
+if not os.getenv("OPENAI_API_KEY"):
+    print("[skip] OPENAI_API_KEY not set")
+    sys.exit(0)
+
+try:
+    import openai
+except ImportError:
+    print("[skip] openai SDK not installed")
+    sys.exit(0)
+
+# Heavy imports only after skip-guards pass
 from praisonai import Agent
 from praisonai.integrations import LocalAgent, LocalAgentConfig
 

tests/unit/integrations/test_backend_semantics.py

@@ -94,25 +94,23 @@ def test_managed_agent_deprecation_warnings():
             assert "LocalAgent" in str(w[0].message)
 
 
-def test_managed_agent_compute_provider_errors():
-    """Test that ManagedAgent raises proper errors for compute provider names."""
+def test_managed_agent_compute_provider_warnings():
+    """Test that ManagedAgent(provider='modal'|'e2b'|...) emits DeprecationWarning and returns LocalManagedAgent."""
     from praisonai.integrations.managed_agents import ManagedAgent
+    from praisonai.integrations.managed_local import LocalManagedAgent
 
-    # Compute providers should raise ValueError 
-    with pytest.raises(ValueError) as exc_info:
-        ManagedAgent(provider="modal")
-    assert "compute" in str(exc_info.value).lower()
-    assert "LocalAgent" in str(exc_info.value)
+    # Compute providers should emit DeprecationWarning and return LocalManagedAgent (backward compatibility)
+    with pytest.warns(DeprecationWarning, match="compute.*deprecated"):
+        obj = ManagedAgent(provider="modal")
+    assert isinstance(obj, LocalManagedAgent)
 
-    with pytest.raises(ValueError) as exc_info:
-        ManagedAgent(provider="e2b")
-    assert "compute" in str(exc_info.value).lower()
-    assert "LocalAgent" in str(exc_info.value)
+    with pytest.warns(DeprecationWarning, match="compute.*deprecated"):
+        obj = ManagedAgent(provider="e2b")
+    assert isinstance(obj, LocalManagedAgent)
 
-    with pytest.raises(ValueError) as exc_info:
-        ManagedAgent(provider="docker")
-    assert "compute" in str(exc_info.value).lower()
-    assert "LocalAgent" in str(exc_info.value)
+    with pytest.warns(DeprecationWarning, match="compute.*deprecated"):
+        obj = ManagedAgent(provider="docker")
+    assert isinstance(obj, LocalManagedAgent)
 
 
 def test_managed_agent_anthropic_passthrough():