jarviscore-framework 0.3.0__py3-none-any.whl → 0.3.1__py3-none-any.whl

examples/cloud_deployment_example.py

@@ -28,10 +28,10 @@ import sys
 
 sys.path.insert(0, '.')
 
-from jarviscore.profiles import ListenerAgent
+from jarviscore.profiles import CustomAgent
 
 
-class StandaloneProcessor(ListenerAgent):
+class StandaloneProcessor(CustomAgent):
     """
     Example standalone agent that joins mesh independently.
 
@@ -143,7 +143,7 @@ async def main():
     print("Listening for peer requests...")
     print("Press Ctrl+C to stop.\n")
 
-    # Run agent (ListenerAgent's run() handles the message loop)
+    # Run agent (CustomAgent's run() handles the message loop)
     try:
         await agent.run()
     except asyncio.CancelledError:

examples/{listeneragent_cognitive_discovery_example.py → customagent_cognitive_discovery_example.py}

@@ -1,9 +1,9 @@
 """
-ListenerAgent + Cognitive Discovery Example
+CustomAgent + Cognitive Discovery Example
 
 Demonstrates two v0.3.0 features:
 
-1. ListenerAgent - Handler-based P2P agents (no run() loop needed)
+1. CustomAgent - Handler-based P2P agents (no run() loop needed)
    - on_peer_request() handles incoming requests
    - on_peer_notify() handles broadcast notifications
 
@@ -25,18 +25,18 @@ from pathlib import Path
 sys.path.insert(0, str(Path(__file__).parent.parent))
 
 from jarviscore import Mesh
-from jarviscore.profiles import ListenerAgent
+from jarviscore.profiles import CustomAgent
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
 # SPECIALIST AGENT - Responds to requests from other agents
 # ═══════════════════════════════════════════════════════════════════════════════
 
-class AnalystAgent(ListenerAgent):
+class AnalystAgent(CustomAgent):
     """
     Specialist agent that handles analysis requests.
 
-    Uses ListenerAgent profile - just implement handlers, no run() loop needed.
+    Uses CustomAgent profile - just implement handlers, no run() loop needed.
     """
     role = "analyst"
     capabilities = ["data_analysis", "statistics", "insights"]
@@ -62,7 +62,7 @@ class AnalystAgent(ListenerAgent):
 # COORDINATOR AGENT - Uses LLM with cognitive discovery
 # ═══════════════════════════════════════════════════════════════════════════════
 
-class CoordinatorAgent(ListenerAgent):
+class CoordinatorAgent(CustomAgent):
     """
     Coordinator agent that uses LLM with dynamic peer discovery.
 

examples/fastapi_integration_example.py

@@ -5,7 +5,7 @@ Demonstrates JarvisLifespan for 3-line FastAPI integration with autonomous agent
 
 Features shown:
     1. JarvisLifespan - Automatic agent lifecycle management
-    2. ListenerAgent - API-first agents with on_peer_request handlers
+    2. CustomAgent - API-first agents with on_peer_request handlers
     3. Cognitive Discovery - get_cognitive_context() for LLM awareness
     4. Autonomous Agents - Each agent has MESH as a TOOL, LLM decides when to delegate
 
@@ -45,14 +45,14 @@ except ImportError:
     FASTAPI_AVAILABLE = False
     print("FastAPI not installed. Run: pip install fastapi uvicorn")
 
-from jarviscore.profiles import ListenerAgent
+from jarviscore.profiles import CustomAgent
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
 # LLM-POWERED AGENT BASE - Each agent can discover and delegate
 # ═══════════════════════════════════════════════════════════════════════════════
 
-class LLMAgent(ListenerAgent):
+class LLMAgent(CustomAgent):
     """
     Base for LLM-powered agents that can discover and delegate to peers.
 
@@ -544,7 +544,7 @@ def main():
     print("=" * 60)
     print("\n - FastAPI Integration:")
     print("  - JarvisLifespan for one-line integration")
-    print("  - ListenerAgent with on_peer_request handlers")
+    print("  - CustomAgent with on_peer_request handlers")
     print("  - Cognitive discovery via get_cognitive_context()")
     print("\n - Cloud Deployment:")
     print("  - Each agent has MESH as a TOOL")

jarviscore/__init__.py

@@ -4,16 +4,15 @@ JarvisCore - P2P Distributed Agent Framework
 A production-grade framework for building autonomous agent systems with:
 - P2P coordination via SWIM protocol
 - Workflow orchestration with dependencies
-- Three agent profiles: AutoAgent, CustomAgent, and ListenerAgent
+- Two agent profiles: AutoAgent and CustomAgent
 
 Profiles:
-    AutoAgent     - LLM generates and executes code from prompts (autonomous mode)
-    CustomAgent   - You provide execute_task() or run() (p2p/distributed modes)
-    ListenerAgent - API-first agents with background P2P (just implement handlers)
+    AutoAgent   - LLM generates and executes code from prompts (autonomous mode)
+    CustomAgent - You provide handlers or execute_task() (p2p/distributed modes)
 
 Modes:
     autonomous  - Workflow engine only (AutoAgent)
-    p2p         - P2P coordinator only (CustomAgent/ListenerAgent with run() loops)
+    p2p         - P2P coordinator only (CustomAgent with run() loop)
     distributed - Both workflow + P2P (CustomAgent with execute_task())
 
 Quick Start (AutoAgent - autonomous mode):
@@ -30,12 +29,12 @@ Quick Start (AutoAgent - autonomous mode):
     await mesh.start()
     results = await mesh.workflow("calc", [{"agent": "calculator", "task": "Calculate 10!"}])
 
-Quick Start (ListenerAgent + FastAPI):
+Quick Start (CustomAgent + FastAPI):
     from fastapi import FastAPI
-    from jarviscore.profiles import ListenerAgent
+    from jarviscore.profiles import CustomAgent
     from jarviscore.integrations.fastapi import JarvisLifespan
 
-    class MyAgent(ListenerAgent):
+    class MyAgent(CustomAgent):
         role = "processor"
         capabilities = ["processing"]
 
@@ -61,7 +60,7 @@ Quick Start (CustomAgent - distributed mode):
     results = await mesh.workflow("demo", [{"agent": "processor", "task": "hello"}])
 """
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"
 __author__ = "JarvisCore Contributors"
 __license__ = "MIT"
 
@@ -73,7 +72,6 @@ from jarviscore.core.mesh import Mesh, MeshMode
 # Execution profiles
 from jarviscore.profiles.autoagent import AutoAgent
 from jarviscore.profiles.customagent import CustomAgent
-from jarviscore.profiles.listeneragent import ListenerAgent
 
 # Custom Profile: Decorator, Wrapper, and Context
 from jarviscore.adapter import jarvis_agent, wrap
@@ -99,7 +97,6 @@ __all__ = [
     # Profiles
     "AutoAgent",
     "CustomAgent",
-    "ListenerAgent",
 
     # Custom Profile (decorator and wrapper)
     "jarvis_agent",

jarviscore/cli/smoketest.py

@@ -313,7 +313,7 @@ class SmokeTest:
         print("\nJarvisCore is working correctly. Next steps:")
         print("  1. AutoAgent example:     python examples/calculator_agent_example.py")
         print("  2. CustomAgent P2P:       python examples/customagent_p2p_example.py")
-        print("  3. ListenerAgent (v0.3):  python examples/listeneragent_cognitive_discovery_example.py")
+        print("  3. Cognitive Discovery:   python examples/customagent_cognitive_discovery_example.py")
         print("  4. FastAPI (v0.3):        python examples/fastapi_integration_example.py")
         print("  5. Cloud deploy (v0.3):   python examples/cloud_deployment_example.py")
         print("\nDocumentation:")

jarviscore/core/mesh.py

@@ -256,9 +256,18 @@ class Mesh:
             await self._p2p_coordinator.start()
             self._logger.info("✓ P2P coordinator started")
 
+            # Wait for mesh to stabilize before announcing
+            # Increased delay to ensure SWIM fully connects all nodes
+            await asyncio.sleep(5)
+            self._logger.info("Waited for mesh stabilization")
+
             # Announce capabilities to network
             await self._p2p_coordinator.announce_capabilities()
             self._logger.info("✓ Capabilities announced to mesh")
+            
+            # Request capabilities from existing peers (for late-joiners)
+            await self._p2p_coordinator.request_peer_capabilities()
+            self._logger.info("✓ Requested capabilities from existing peers")
 
         # Inject PeerClients for p2p mode
         if self.mode == MeshMode.P2P:

jarviscore/data/examples/cloud_deployment_example.py

@@ -28,10 +28,10 @@ import sys
 
 sys.path.insert(0, '.')
 
-from jarviscore.profiles import ListenerAgent
+from jarviscore.profiles import CustomAgent
 
 
-class StandaloneProcessor(ListenerAgent):
+class StandaloneProcessor(CustomAgent):
     """
     Example standalone agent that joins mesh independently.
 
@@ -143,7 +143,7 @@ async def main():
     print("Listening for peer requests...")
     print("Press Ctrl+C to stop.\n")
 
-    # Run agent (ListenerAgent's run() handles the message loop)
+    # Run agent (CustomAgent's run() handles the message loop)
     try:
         await agent.run()
     except asyncio.CancelledError:

jarviscore/data/examples/custom_profile_decorator.py

@@ -0,0 +1,134 @@
+"""
+Custom Profile Example: Using @jarvis_agent Decorator
+
+This example shows how to use the @jarvis_agent decorator to convert
+any Python class into a JarvisCore agent without modifying the class.
+
+Use Case: You have existing Python classes/agents and want JarvisCore
+to handle orchestration (data handoff, dependencies, shared memory).
+"""
+import asyncio
+from jarviscore import Mesh, jarvis_agent, JarvisContext
+
+
+# Example 1: Simple decorator (no context needed)
+@jarvis_agent(role="processor", capabilities=["data_processing"])
+class DataProcessor:
+    """Simple data processor - doubles input values."""
+
+    def run(self, data):
+        """Process data by doubling values."""
+        if isinstance(data, list):
+            return {"processed": [x * 2 for x in data]}
+        return {"processed": data * 2}
+
+
+# Example 2: Decorator with context access
+@jarvis_agent(role="aggregator", capabilities=["aggregation"])
+class Aggregator:
+    """Aggregates results from previous steps using JarvisContext."""
+
+    def run(self, task, ctx: JarvisContext):
+        """
+        Access previous step results via ctx.previous().
+
+        Args:
+            task: The task description
+            ctx: JarvisContext with memory and dependency access
+        """
+        # Get output from a specific previous step
+        processed = ctx.previous("step1")
+
+        if processed:
+            data = processed.get("processed", [])
+            return {
+                "sum": sum(data) if isinstance(data, list) else data,
+                "count": len(data) if isinstance(data, list) else 1,
+                "source_step": "step1"
+            }
+
+        return {"error": "No previous data found"}
+
+
+# Example 3: Decorator with custom execute method
+@jarvis_agent(role="validator", capabilities=["validation"], execute_method="validate")
+class DataValidator:
+    """Validates data using a custom method name."""
+
+    def validate(self, data):
+        """Custom execute method - validates input data."""
+        if isinstance(data, list):
+            return {
+                "valid": all(isinstance(x, (int, float)) for x in data),
+                "count": len(data),
+                "type": "list"
+            }
+        return {
+            "valid": isinstance(data, (int, float)),
+            "type": type(data).__name__
+        }
+
+
+async def main():
+    """Run a multi-step workflow with custom profile agents."""
+    print("=" * 60)
+    print("  Custom Profile Example: @jarvis_agent Decorator")
+    print("=" * 60)
+
+    # Create mesh in autonomous mode
+    mesh = Mesh(mode="autonomous")
+
+    # Add our decorated agents
+    mesh.add(DataProcessor)
+    mesh.add(Aggregator)
+    mesh.add(DataValidator)
+
+    # Start the mesh
+    await mesh.start()
+
+    try:
+        # Execute a multi-step workflow
+        print("\nExecuting workflow with 3 steps...\n")
+
+        results = await mesh.workflow("custom-profile-demo", [
+            {
+                "id": "step1",
+                "agent": "processor",
+                "task": "Process input data",
+                "params": {"data": [1, 2, 3, 4, 5]}
+            },
+            {
+                "id": "step2",
+                "agent": "aggregator",
+                "task": "Aggregate processed results",
+                "depends_on": ["step1"]  # Wait for step1
+            },
+            {
+                "id": "step3",
+                "agent": "validator",
+                "task": "Validate original data",
+                "params": {"data": [1, 2, 3, 4, 5]}
+            }
+        ])
+
+        # Print results
+        print("Results:")
+        print("-" * 40)
+
+        for i, result in enumerate(results):
+            step_name = ["Processor", "Aggregator", "Validator"][i]
+            print(f"\n{step_name} (step{i+1}):")
+            print(f"  Status: {result.get('status')}")
+            print(f"  Output: {result.get('output')}")
+
+        print("\n" + "=" * 60)
+        print("  Workflow completed successfully!")
+        print("=" * 60)
+
+    finally:
+        # Stop the mesh
+        await mesh.stop()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

jarviscore/data/examples/custom_profile_wrap.py

@@ -0,0 +1,168 @@
+"""
+Custom Profile Example: Using wrap() Function
+
+This example shows how to use the wrap() function to convert
+an existing instance into a JarvisCore agent.
+
+Use Case: You have an already-instantiated object (like a LangChain
+agent, CrewAI agent, or any configured instance) and want to use it
+with JarvisCore orchestration.
+"""
+import asyncio
+from jarviscore import Mesh, wrap, JarvisContext
+
+
+# Simulate an existing "LangChain-like" agent
+class ExternalLLMAgent:
+    """
+    Simulates an external LLM agent (like LangChain).
+    In real usage, this would be your actual LangChain/CrewAI agent.
+    """
+
+    def __init__(self, model_name: str, temperature: float = 0.7):
+        self.model_name = model_name
+        self.temperature = temperature
+        print(f"  Initialized ExternalLLMAgent with {model_name}")
+
+    def invoke(self, query: str) -> dict:
+        """LangChain-style invoke method."""
+        # Simulate LLM response
+        return {
+            "answer": f"Response to '{query}' from {self.model_name}",
+            "model": self.model_name,
+            "tokens_used": len(query.split()) * 10
+        }
+
+
+# Simulate a data processing service
+class DataService:
+    """Simulates an external data processing service."""
+
+    def __init__(self, api_url: str):
+        self.api_url = api_url
+        print(f"  Initialized DataService with {api_url}")
+
+    def run(self, data):
+        """Process data through the service."""
+        if isinstance(data, list):
+            return {
+                "transformed": [x ** 2 for x in data],
+                "source": self.api_url
+            }
+        return {"transformed": data ** 2, "source": self.api_url}
+
+
+# Simulate an agent that needs context
+class ContextAwareProcessor:
+    """Agent that uses JarvisContext to access previous results."""
+
+    def run(self, task, ctx: JarvisContext):
+        """Process with context access."""
+        # Get all previous results
+        all_previous = ctx.all_previous()
+
+        summary = {
+            "task": task,
+            "previous_steps": list(all_previous.keys()),
+            "combined_data": {}
+        }
+
+        for step_id, output in all_previous.items():
+            if isinstance(output, dict):
+                summary["combined_data"][step_id] = output
+
+        return summary
+
+
+async def main():
+    """Demonstrate wrapping existing instances."""
+    print("=" * 60)
+    print("  Custom Profile Example: wrap() Function")
+    print("=" * 60)
+
+    # Create instances of "external" agents
+    print("\nCreating external agent instances...")
+    llm_agent = ExternalLLMAgent(model_name="gpt-4-turbo", temperature=0.3)
+    data_service = DataService(api_url="https://api.example.com/process")
+    context_processor = ContextAwareProcessor()
+
+    # Wrap them for JarvisCore
+    print("\nWrapping instances for JarvisCore...")
+
+    wrapped_llm = wrap(
+        llm_agent,
+        role="llm_assistant",
+        capabilities=["chat", "qa"],
+        execute_method="invoke"  # LangChain uses "invoke"
+    )
+
+    wrapped_data = wrap(
+        data_service,
+        role="data_processor",
+        capabilities=["data_processing", "transformation"]
+        # execute_method auto-detected as "run"
+    )
+
+    wrapped_context = wrap(
+        context_processor,
+        role="context_aggregator",
+        capabilities=["aggregation", "summary"]
+    )
+
+    # Create mesh and add wrapped agents
+    mesh = Mesh(mode="autonomous")
+    mesh.add(wrapped_llm)
+    mesh.add(wrapped_data)
+    mesh.add(wrapped_context)
+
+    await mesh.start()
+
+    try:
+        print("\nExecuting workflow with wrapped agents...\n")
+
+        results = await mesh.workflow("wrap-demo", [
+            {
+                "id": "llm_step",
+                "agent": "llm_assistant",
+                "task": "What is the capital of France?",
+                "params": {"query": "What is the capital of France?"}
+            },
+            {
+                "id": "data_step",
+                "agent": "data_processor",
+                "task": "Transform numbers",
+                "params": {"data": [1, 2, 3, 4, 5]}
+            },
+            {
+                "id": "summary_step",
+                "agent": "context_aggregator",
+                "task": "Summarize all results",
+                "depends_on": ["llm_step", "data_step"]
+            }
+        ])
+
+        # Print results
+        print("Results:")
+        print("-" * 40)
+
+        step_names = ["LLM Assistant", "Data Processor", "Context Aggregator"]
+        for i, result in enumerate(results):
+            print(f"\n{step_names[i]}:")
+            print(f"  Status: {result.get('status')}")
+            output = result.get('output', {})
+            if isinstance(output, dict):
+                for key, value in output.items():
+                    print(f"  {key}: {value}")
+            else:
+                print(f"  Output: {output}")
+
+        print("\n" + "=" * 60)
+        print("  Workflow with wrapped instances completed!")
+        print("=" * 60)
+
+    finally:
+        await mesh.stop()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

jarviscore/data/examples/{listeneragent_cognitive_discovery_example.py → customagent_cognitive_discovery_example.py}

@@ -1,9 +1,9 @@
 """
-ListenerAgent + Cognitive Discovery Example
+CustomAgent + Cognitive Discovery Example
 
 Demonstrates two v0.3.0 features:
 
-1. ListenerAgent - Handler-based P2P agents (no run() loop needed)
+1. CustomAgent - Handler-based P2P agents (no run() loop needed)
    - on_peer_request() handles incoming requests
    - on_peer_notify() handles broadcast notifications
 
@@ -25,18 +25,18 @@ from pathlib import Path
 sys.path.insert(0, str(Path(__file__).parent.parent))
 
 from jarviscore import Mesh
-from jarviscore.profiles import ListenerAgent
+from jarviscore.profiles import CustomAgent
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
 # SPECIALIST AGENT - Responds to requests from other agents
 # ═══════════════════════════════════════════════════════════════════════════════
 
-class AnalystAgent(ListenerAgent):
+class AnalystAgent(CustomAgent):
     """
     Specialist agent that handles analysis requests.
 
-    Uses ListenerAgent profile - just implement handlers, no run() loop needed.
+    Uses CustomAgent profile - just implement handlers, no run() loop needed.
     """
     role = "analyst"
     capabilities = ["data_analysis", "statistics", "insights"]
@@ -62,7 +62,7 @@ class AnalystAgent(ListenerAgent):
 # COORDINATOR AGENT - Uses LLM with cognitive discovery
 # ═══════════════════════════════════════════════════════════════════════════════
 
-class CoordinatorAgent(ListenerAgent):
+class CoordinatorAgent(CustomAgent):
     """
     Coordinator agent that uses LLM with dynamic peer discovery.
 

jarviscore/data/examples/fastapi_integration_example.py

@@ -5,7 +5,7 @@ Demonstrates JarvisLifespan for 3-line FastAPI integration with autonomous agent
 
 Features shown:
     1. JarvisLifespan - Automatic agent lifecycle management
-    2. ListenerAgent - API-first agents with on_peer_request handlers
+    2. CustomAgent - API-first agents with on_peer_request handlers
     3. Cognitive Discovery - get_cognitive_context() for LLM awareness
     4. Autonomous Agents - Each agent has MESH as a TOOL, LLM decides when to delegate
 
@@ -45,14 +45,14 @@ except ImportError:
     FASTAPI_AVAILABLE = False
     print("FastAPI not installed. Run: pip install fastapi uvicorn")
 
-from jarviscore.profiles import ListenerAgent
+from jarviscore.profiles import CustomAgent
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
 # LLM-POWERED AGENT BASE - Each agent can discover and delegate
 # ═══════════════════════════════════════════════════════════════════════════════
 
-class LLMAgent(ListenerAgent):
+class LLMAgent(CustomAgent):
     """
     Base for LLM-powered agents that can discover and delegate to peers.
 
@@ -544,7 +544,7 @@ def main():
     print("=" * 60)
     print("\n - FastAPI Integration:")
     print("  - JarvisLifespan for one-line integration")
-    print("  - ListenerAgent with on_peer_request handlers")
+    print("  - CustomAgent with on_peer_request handlers")
     print("  - Cognitive discovery via get_cognitive_context()")
     print("\n - Cloud Deployment:")
     print("  - Each agent has MESH as a TOOL")