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

{jarviscore_framework-0.3.0.dist-info → jarviscore_framework-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jarviscore-framework
-Version: 0.3.0
+Version: 0.3.2
 Summary: Build autonomous AI agents in 3 lines of code. Production-ready orchestration with P2P mesh networking.
 Author-email: Ruth Mutua <mutuandinda82@gmail.com>, Muyukani Kizito <muyukani@prescottdata.io>
 Maintainer-email: Prescott Data <info@prescottdata.io>
@@ -26,6 +26,8 @@ Requires-Dist: pyzmq
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: aiohttp>=3.9.0
 Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: fastapi>=0.104.0
+Requires-Dist: uvicorn>=0.29.0
 Requires-Dist: anthropic>=0.18.0
 Requires-Dist: openai>=1.0.0
 Requires-Dist: google-genai>=1.0.0
@@ -47,13 +49,13 @@ Dynamic: license-file
 
 ## Features
 
-- ✅ **AutoAgent** - LLM generates and executes code from natural language
-- ✅ **CustomAgent** - Bring your own logic (LangChain, CrewAI, etc.)
-- ✅ **ListenerAgent** - API-first agents with background P2P (just implement handlers)
-- ✅ **P2P Mesh** - Agent discovery and communication via SWIM protocol
-- ✅ **Workflow Orchestration** - Dependencies, context passing, multi-step pipelines
-- ✅ **FastAPI Integration** - 3-line setup with JarvisLifespan
-- ✅ **Cloud Deployment** - Self-registering agents for Docker/K8s
+- **AutoAgent** - LLM generates and executes code from natural language
+- **CustomAgent** - Bring your own logic with P2P message handlers
+- **P2P Mesh** - Agent discovery and communication via SWIM protocol
+- **Workflow Orchestration** - Dependencies, context passing, multi-step pipelines
+- **FastAPI Integration** - 3-line setup with JarvisLifespan
+- **Cognitive Discovery** - LLM-ready peer descriptions for autonomous delegation
+- **Cloud Deployment** - Self-registering agents for Docker/K8s
 
 ## Installation
 
@@ -97,7 +99,26 @@ results = await mesh.workflow("calc", [
 print(results[0]["output"])  # 3628800
 ```
 
-### CustomAgent (Your Code)
+### CustomAgent + FastAPI (Recommended)
+
+```python
+from fastapi import FastAPI
+from jarviscore.profiles import CustomAgent
+from jarviscore.integrations.fastapi import JarvisLifespan
+
+class ProcessorAgent(CustomAgent):
+    role = "processor"
+    capabilities = ["processing"]
+
+    async def on_peer_request(self, msg):
+        # Handle requests from other agents
+        return {"result": msg.data.get("task", "").upper()}
+
+# 3 lines to integrate with FastAPI
+app = FastAPI(lifespan=JarvisLifespan(ProcessorAgent(), mode="p2p"))
+```
+
+### CustomAgent (Workflow Mode)
 
 ```python
 from jarviscore import Mesh
@@ -121,56 +142,50 @@ results = await mesh.workflow("demo", [
 print(results[0]["output"])  # [2, 4, 6]
 ```
 
-### ListenerAgent + FastAPI (API-First)
+## Profiles
 
-```python
-from fastapi import FastAPI
-from jarviscore.profiles import ListenerAgent
-from jarviscore.integrations.fastapi import JarvisLifespan
-
-class ProcessorAgent(ListenerAgent):
-    role = "processor"
-    capabilities = ["processing"]
-
-    async def on_peer_request(self, msg):
-        # Handle requests from other agents
-        return {"result": msg.data.get("task", "").upper()}
-
-# That's it - 3 lines to integrate with FastAPI
-app = FastAPI(lifespan=JarvisLifespan(ProcessorAgent(), mode="p2p"))
-```
+| Profile | You Write | JarvisCore Handles |
+|---------|-----------|-------------------|
+| **AutoAgent** | System prompt | LLM code generation, sandboxed execution |
+| **CustomAgent** | `on_peer_request()` and/or `execute_task()` | Mesh, discovery, routing, lifecycle |
 
 ## Execution Modes
 
-| Mode | Profile | Use Case |
-|------|---------|----------|
-| `autonomous` | AutoAgent | Single machine, LLM code generation |
-| `p2p` | CustomAgent, ListenerAgent | Agent-to-agent communication, swarms |
-| `distributed` | CustomAgent, ListenerAgent | Multi-node workflows + P2P |
+| Mode | Use Case |
+|------|----------|
+| `autonomous` | Single machine, LLM code generation (AutoAgent) |
+| `p2p` | Agent-to-agent communication, swarms (CustomAgent) |
+| `distributed` | Multi-node workflows + P2P (CustomAgent) |
 
-## What's New in 0.3.0
+## Framework Integration
 
-**Developer Experience Improvements:**
-- **ListenerAgent** - No more writing `run()` loops. Just implement `on_peer_request()` and `on_peer_notify()` handlers.
-- **JarvisLifespan** - FastAPI integration reduced from ~100 lines to 3 lines.
-- **Cognitive Discovery** - `peers.get_cognitive_context()` generates LLM-ready peer descriptions. No more hardcoded agent names in prompts.
+JarvisCore is **async-first**. Best experience with async frameworks.
 
-**Cloud Deployment:**
-- **Self-Registration** - `agent.join_mesh()` lets agents join existing meshes without central orchestrator.
-- **Remote Visibility** - Agents on different nodes are automatically discovered and callable.
+| Framework | Integration |
+|-----------|-------------|
+| **FastAPI** | `JarvisLifespan` (3 lines) |
+| **aiohttp, Quart, Tornado** | Manual lifecycle (see docs) |
+| **Flask, Django** | Background thread pattern (see docs) |
 
 ## Documentation
 
-- [User Guide](jarviscore/docs/USER_GUIDE.md) - Complete documentation
-- [Getting Started](jarviscore/docs/GETTING_STARTED.md) - 5-minute quickstart
-- [AutoAgent Guide](jarviscore/docs/AUTOAGENT_GUIDE.md) - LLM-powered agents
-- [CustomAgent Guide](jarviscore/docs/CUSTOMAGENT_GUIDE.md) - Bring your own code
-- [API Reference](jarviscore/docs/API_REFERENCE.md) - Detailed API docs
-- [Configuration](jarviscore/docs/CONFIGURATION.md) - Settings reference
+Documentation is included with the package:
+
+```bash
+python -c "import jarviscore; print(jarviscore.__path__[0] + '/docs')"
+```
+
+**Available guides:**
+- `GETTING_STARTED.md` - 5-minute quickstart
+- `CUSTOMAGENT_GUIDE.md` - CustomAgent patterns and framework integration
+- `AUTOAGENT_GUIDE.md` - LLM-powered agents
+- `USER_GUIDE.md` - Complete documentation
+- `API_REFERENCE.md` - Detailed API docs
+- `CONFIGURATION.md` - Settings reference
 
 ## Version
 
-**0.3.0**
+**0.3.2**
 
 ## License
 

{jarviscore_framework-0.3.0.dist-info → jarviscore_framework-0.3.2.dist-info}/RECORD

@@ -1,15 +1,15 @@
 examples/autoagent_distributed_example.py,sha256=yXxabyqPqPc-CTroTf-0GAl63ln3zPRMhMYBEi1Tpsc,8586
 examples/calculator_agent_example.py,sha256=x7TrzE45WT_1DqwEnw8U3Fw56WpR9jBe3SLZz5vsKWc,2276
-examples/cloud_deployment_example.py,sha256=PhB9-3pGgVY_w2UkTlBLGma_JSVEhG6hInxCDODOKwg,5044
+examples/cloud_deployment_example.py,sha256=R0WVtta6hi_yuhWVnnQ5X_wiztPSRLC2gfhoDMgUakw,5038
 examples/custom_profile_decorator.py,sha256=4EAgqXrT9an1f5AQ3cEWAhPvI_EeXbQq7O8ByunXb_M,4099
 examples/custom_profile_wrap.py,sha256=0NoQECVBEJOiL7Syr2QL73jnvj2XhGQZUhOvisqEQXw,5088
-examples/customagent_distributed_example.py,sha256=_vt_2sqSCIdHgwuV4VQFzHzmC3bgemPrHFifeA5tRNE,13677
+examples/customagent_cognitive_discovery_example.py,sha256=UfdQm9j11G38IfHPyBguQSmxODU7A5Niod95aydNb7s,14835
+examples/customagent_distributed_example.py,sha256=RA-zvRjPq2YrGfKU6_dP4ZuEVwivKdA3NNPty6j_GmA,18951
 examples/customagent_p2p_example.py,sha256=tWywC5abc1aYIyW2V6Xgr_XkjZdqzcOeLut3PnzUpB8,30669
-examples/fastapi_integration_example.py,sha256=BBWHwLCD6qYF56jkfW9cLIAWHCgx6EWyRpiRCwwr6D4,22470
-examples/listeneragent_cognitive_discovery_example.py,sha256=ycPj2UzN9AMgUInca0CJZF0tZ8x7BMP8Xk1dsHhMG78,12964
+examples/fastapi_integration_example.py,sha256=qWob72OD2BLf-SlpvwKjfzgyTZo97DL2ttp-Ox56280,24790
 examples/multi_agent_workflow.py,sha256=Sygx3iEBM9WzorVMXqtiwn4rLYrW9BsxsiQSKceuzsE,4303
 examples/research_agent_example.py,sha256=phJ5AHNnZ_pxCfiKvHoTp_IFwOAW7VD1fRNHlXvfgj4,2287
-jarviscore/__init__.py,sha256=p_jA9o1KGmXiQS0iKZPVvFZjUZcz2OXR3mAfpYUWKuo,3609
+jarviscore/__init__.py,sha256=MFMKSUN3tqYyUAXHKrHWp6GyptOeg_wbg7CgbEfqZwA,3402
 jarviscore/adapter/__init__.py,sha256=fipq2XzgW3Us35tbFhs9B_ypoeEZeaP7bTsNPFFZVRk,1092
 jarviscore/adapter/decorator.py,sha256=ZY-WCF16EvtQWkra_6HNBKdTOJ0G5yvrD5PYKa6bcqk,12040
 jarviscore/adapter/wrapper.py,sha256=kU9nBiezU1M1dq9x5EjnAVHs_QjFFOFx7dR4TNyFdPk,9666
@@ -17,7 +17,7 @@ jarviscore/cli/__init__.py,sha256=OnpJ37xDcbh3jFhALLY1jimgp1mxlB1-VhsKhGS6TDY,12
 jarviscore/cli/__main__.py,sha256=GuIqW9NKJ3n70ei54ItzrBYEVaWG5dAWGxdu87w7YgI,829
 jarviscore/cli/check.py,sha256=eWvk6fkRsJ8hpgT60XUoAn_0nyzF0PFKRl65m7U9cxQ,13955
 jarviscore/cli/scaffold.py,sha256=LZhqOSUVO7ZgBZnu2M2pUsRmTXtInYfOVJDaPkVE0Ck,4898
-jarviscore/cli/smoketest.py,sha256=gNTlPfJYQYQesVNSqx0fOsIMtRIHUa5GWHRqWcibPQc,13772
+jarviscore/cli/smoketest.py,sha256=lRmpBBgo4jWuf6wiEEl8n0rb6dYQnKZ-ud2kodPmoEM,13770
 jarviscore/config/__init__.py,sha256=ZLjbRHSi5azaDyoSOFr9cQ65J5Fvi56xI-WHdczc204,178
 jarviscore/config/settings.py,sha256=ueYpJAZxT1zoEPymzrn0OHAXZxQXBqSMs87VwolPdhg,3516
 jarviscore/context/__init__.py,sha256=FdMfHUPs1vDRDaz2WR_F3IJi9k4FIVBvsGVKD5dJBrQ,1171
@@ -26,27 +26,29 @@ jarviscore/context/jarvis_context.py,sha256=6ai2TjDE5PRiBxF5lTdyBMoK3b8wv6cr0a6q
 jarviscore/context/memory.py,sha256=taonyl24ZUe-NZ5VtvrxljNv6f_BebuH6VE7l0B9S7A,4442
 jarviscore/core/__init__.py,sha256=30K2aqZckYTRZupn6X-mGV2QDSqWCgJ1cpN6Zk1gqlQ,177
 jarviscore/core/agent.py,sha256=j76BGNwN6ATnjWujvBSz8Dvojz7W9AEzC7gxfs9xde4,15561
-jarviscore/core/mesh.py,sha256=XPAX_mRqpLj22vT9SI4MmyT65EQR9KxTEULqJ3BlHwk,22898
+jarviscore/core/mesh.py,sha256=wPgrppzIXtqzhUdaCqNL4OvLpSBCUiAwxzcs-19Bpzg,29407
 jarviscore/core/profile.py,sha256=sTrGTxV9mAqbt5l3z0-BSNOeWzq8YDLR3mlaPFSgt1c,2190
 jarviscore/data/.env.example,sha256=TCPdye7tYNDOEpcgaEuzUsQ-H7m9G6rsyzNZV9IYQ9s,5156
 jarviscore/data/__init__.py,sha256=757nsqMkytYV0zXiM_mh3LqtGZZ1lgFuMzvaLrW51PM,151
 jarviscore/data/examples/autoagent_distributed_example.py,sha256=yXxabyqPqPc-CTroTf-0GAl63ln3zPRMhMYBEi1Tpsc,8586
 jarviscore/data/examples/calculator_agent_example.py,sha256=x7TrzE45WT_1DqwEnw8U3Fw56WpR9jBe3SLZz5vsKWc,2276
-jarviscore/data/examples/cloud_deployment_example.py,sha256=PhB9-3pGgVY_w2UkTlBLGma_JSVEhG6hInxCDODOKwg,5044
-jarviscore/data/examples/customagent_distributed_example.py,sha256=_vt_2sqSCIdHgwuV4VQFzHzmC3bgemPrHFifeA5tRNE,13677
+jarviscore/data/examples/cloud_deployment_example.py,sha256=R0WVtta6hi_yuhWVnnQ5X_wiztPSRLC2gfhoDMgUakw,5038
+jarviscore/data/examples/custom_profile_decorator.py,sha256=4EAgqXrT9an1f5AQ3cEWAhPvI_EeXbQq7O8ByunXb_M,4099
+jarviscore/data/examples/custom_profile_wrap.py,sha256=0NoQECVBEJOiL7Syr2QL73jnvj2XhGQZUhOvisqEQXw,5088
+jarviscore/data/examples/customagent_cognitive_discovery_example.py,sha256=UfdQm9j11G38IfHPyBguQSmxODU7A5Niod95aydNb7s,14835
+jarviscore/data/examples/customagent_distributed_example.py,sha256=RA-zvRjPq2YrGfKU6_dP4ZuEVwivKdA3NNPty6j_GmA,18951
 jarviscore/data/examples/customagent_p2p_example.py,sha256=tWywC5abc1aYIyW2V6Xgr_XkjZdqzcOeLut3PnzUpB8,30669
-jarviscore/data/examples/fastapi_integration_example.py,sha256=BBWHwLCD6qYF56jkfW9cLIAWHCgx6EWyRpiRCwwr6D4,22470
-jarviscore/data/examples/listeneragent_cognitive_discovery_example.py,sha256=ycPj2UzN9AMgUInca0CJZF0tZ8x7BMP8Xk1dsHhMG78,12964
+jarviscore/data/examples/fastapi_integration_example.py,sha256=qWob72OD2BLf-SlpvwKjfzgyTZo97DL2ttp-Ox56280,24790
 jarviscore/data/examples/multi_agent_workflow.py,sha256=Sygx3iEBM9WzorVMXqtiwn4rLYrW9BsxsiQSKceuzsE,4303
 jarviscore/data/examples/research_agent_example.py,sha256=phJ5AHNnZ_pxCfiKvHoTp_IFwOAW7VD1fRNHlXvfgj4,2287
-jarviscore/docs/API_REFERENCE.md,sha256=Izzo41VfrH2UtenMLzFk91HzPejTtBXdM6E_LoLqa0M,31837
+jarviscore/docs/API_REFERENCE.md,sha256=duRyLZ9uDu4EgyTjOPThHpBdOp_l6K73yDJLtzXivdU,44404
 jarviscore/docs/AUTOAGENT_GUIDE.md,sha256=ftm8dymihs3Y9PZTZmSD9xRhlRFygfTZKm59Mz8zNRA,4618
-jarviscore/docs/CHANGELOG.md,sha256=aJmLEaey3SSnyf2cMR-mBRr23tbfnXc2v0Har_11VbY,3259
-jarviscore/docs/CONFIGURATION.md,sha256=gsYElB2XcoSPx_65ca-NBmIe1HY_KS1zQCeFORKZcyI,14910
-jarviscore/docs/CUSTOMAGENT_GUIDE.md,sha256=VXFhP5UH1cIYtTwklxVfpmDDko1GQbJvb0ZmEcSG5i4,67026
-jarviscore/docs/GETTING_STARTED.md,sha256=dyreT-eQCQwSIe1S4yu8XtDN8LzD2vOXXyTxE9wCEkI,19776
-jarviscore/docs/TROUBLESHOOTING.md,sha256=mFTNWIGToGWaHSthVDVtdpw5Y994mSLyv1UuAqzuWEM,11544
-jarviscore/docs/USER_GUIDE.md,sha256=DJQAC2luWvjhSxyAfMKo6T_ZLVEXBjZSmp61u2a5tyo,21078
+jarviscore/docs/CHANGELOG.md,sha256=_NIU7VQHiTB5HLcxw-HyhoDGup8uP2uCTcl6Nw5jQeY,7707
+jarviscore/docs/CONFIGURATION.md,sha256=QiP2RVmZMhbV46S9W0FPKQ2y8P97ZntORtwxH-xPfvc,14910
+jarviscore/docs/CUSTOMAGENT_GUIDE.md,sha256=hMbCD2R7h8gEUwl9usCc7_dNTWRRJ6NoI84Kip3yPX4,82420
+jarviscore/docs/GETTING_STARTED.md,sha256=w_t47M9kQcIG3N6tesMcjQgqpkV7PZOHAOXOSk8yGhE,15860
+jarviscore/docs/TROUBLESHOOTING.md,sha256=iK4kz4x4AsChBPxeOvW6bzg5Gf1XwoZTQEEJYOivtr0,11544
+jarviscore/docs/USER_GUIDE.md,sha256=uOYXABiOpr1e_4QM_8W2xIJtHbdZE6wOS87-U_srdTs,28426
 jarviscore/execution/__init__.py,sha256=yDAMehMO2dVvdKjxVx7zQV2AaxySmvymA24QF3O9tlY,1754
 jarviscore/execution/code_registry.py,sha256=C3_hAVXIeCG31qwSBUrmBBicmd2vnUrXJhJgj8MKlJw,9213
 jarviscore/execution/generator.py,sha256=zY7IxxDu4xoifeuCGZZN8_l8zQCsB5eUO9HGIiLIttw,8696
@@ -56,7 +58,7 @@ jarviscore/execution/result_handler.py,sha256=7SKr-teFksqNgejhnZNrjAzKbtDXbOSV3T
 jarviscore/execution/sandbox.py,sha256=IVkccce_WHDxXO6l8BCcuxAB5iueJfYtbryydoE972c,19981
 jarviscore/execution/search.py,sha256=JSoT8vb_yT6_EKaAgUQDS8ONgFeKf6s8YlEeTn6FaWQ,9923
 jarviscore/integrations/__init__.py,sha256=2Nfn0b_Cpw3Zf64ePYrKTk8PIVqjxK3YGHD4iIURE4A,437
-jarviscore/integrations/fastapi.py,sha256=QBhbnSRYEswl0q94BUt_bbjwa91XekG8czTfGi8tDmY,9238
+jarviscore/integrations/fastapi.py,sha256=fEEHUStGougihJTpHmXmkOcBvRyGElVoMdz7RBq9oRw,9230
 jarviscore/orchestration/__init__.py,sha256=Ia9GfEMWif0tN0Ju89q6M_x_BRw9FcQl5Rf99p8CIKU,386
 jarviscore/orchestration/claimer.py,sha256=ekhHqhtxpi_USnPsIioFK6bA2nhH6jalulBkptYubVU,3106
 jarviscore/orchestration/dependency.py,sha256=UtSSwSC2Ak5V5dYeZWJy3wZZuTE-Y-fcglkoIgNT_70,4377
@@ -64,17 +66,18 @@ jarviscore/orchestration/engine.py,sha256=Xh9Fn3aVY7iwj7cAXdHcN90ogOiVFJlyJeoKnJ
 jarviscore/orchestration/status.py,sha256=XeKASMNQDwpJ6HpDw3m3eAAMNWsWCj4k9jrvMnLHPbo,2540
 jarviscore/p2p/__init__.py,sha256=k1KkBnbb74jrfWKLiKRsMbepy6xBfQZOGzOlDKvslp0,927
 jarviscore/p2p/broadcaster.py,sha256=Gaj0nCHDBQrVe4ob4GcaFSqnAaVe3ugEILslc5Mq1qE,14414
-jarviscore/p2p/coordinator.py,sha256=UtsSVSigIhs2Rcx1v5BVdLC11P649u71y8Bw4cU1fMk,30087
+jarviscore/p2p/coordinator.py,sha256=MMvV7O30Ro0HSRzAT3mpo9p_0QmQoSJ8IJPRkMySOlo,31521
 jarviscore/p2p/keepalive.py,sha256=it0SyXVBmujfE79thrap-A1UxZW01p9ENEIglIbQoAM,14988
-jarviscore/p2p/messages.py,sha256=nd7ZutZ1Xge2C1KkRSwQK3RJ03ScxqESF3fl48hEkhI,2540
-jarviscore/p2p/peer_client.py,sha256=CFOpZ3OUev1W3apD5EaM4uigx5yshhAjNjDEDUJIXMo,31545
-jarviscore/p2p/peer_tool.py,sha256=qXiF0b2pTo8tJ8bUHxe_XbxE0UFgwu2wCpy-W82ocUo,9098
+jarviscore/p2p/messages.py,sha256=ud856fEQQvZz0ngK8vVHKzJ5PlAZGZIRz3e_-DGyNQ4,3151
+jarviscore/p2p/peer_client.py,sha256=ikyn5cPUKODBunEG1qFtd6b_9gaAXYS4Be0sAkR9UL4,44859
+jarviscore/p2p/peer_tool.py,sha256=tMaMGbocGkluOfMEGQABPm37e8Tgr3_PAWZ0urGfFgw,9596
 jarviscore/p2p/swim_manager.py,sha256=mu9clcJ22gqSOoeWlr4QW9b4vhRvD6QEAlTjAVVZvV4,11126
-jarviscore/profiles/__init__.py,sha256=Nxpa31ZZglybHP_2UC2U2ilnQ5GPgJXx4T3uH5QsfnY,455
+jarviscore/profiles/__init__.py,sha256=gg2_T7ONl5se6rCSXLo-OlA3yOzmyHZPaNLzB6zjolE,328
 jarviscore/profiles/autoagent.py,sha256=1nJAVf1oU9lLO47BP1xFGBDZtypXXkwKy6kZjtpdlX0,10424
-jarviscore/profiles/customagent.py,sha256=GRauTYlWyYSgZrWyYZlAPNkJoVgjDHjfY_c0rdeoOgM,4618
-jarviscore/profiles/listeneragent.py,sha256=B4XCdk0T5j6amZmqYztE1m2GCk02ynK5DOdA3VhgHpg,11221
-jarviscore_framework-0.3.0.dist-info/licenses/LICENSE,sha256=SjsXanvmQJFYz_SVFa17O85-bKIa_aG99wrkPpWtypo,1101
+jarviscore/profiles/customagent.py,sha256=--oI_pgKFXprFJXAFD-7Ot9XSYsucr_1L87TOEsJ06g,14279
+jarviscore/testing/__init__.py,sha256=LdPqVN9xfeTBlc4znGcb6kwcTmUdG4Xt7NT77Uu3qOI,869
+jarviscore/testing/mocks.py,sha256=QO-9k5URcRTBRtGCe9v7U8rYT4UalpiQuIidLb51pOE,18949
+jarviscore_framework-0.3.2.dist-info/licenses/LICENSE,sha256=SjsXanvmQJFYz_SVFa17O85-bKIa_aG99wrkPpWtypo,1101
 test_logs/code_registry/functions/data_generator-558779ed_560ebc37.py,sha256=ua0Lueqe1mWCeMpKTMaumfPS-ZrWBFF_Zx6TU5QVjNo,132
 test_logs/code_registry/functions/data_generator-5ed3609e_560ebc37.py,sha256=ua0Lueqe1mWCeMpKTMaumfPS-ZrWBFF_Zx6TU5QVjNo,132
 test_logs/code_registry/functions/data_generator-66da0356_43970bb9.py,sha256=vOkjCOcfXHLJX2TkR3et9vWSwEhCmOn4DdJHMGfTMVY,733
@@ -125,10 +128,15 @@ tests/test_07_distributed_single_node.py,sha256=rFL4FmD5-4MVfgnQ5FwAlIm2FFEdmNOB
 tests/test_08_distributed_multi_node.py,sha256=GkznK1f9aDEFF5_37WhBh553Ov6bw7IDOAvngo4848I,18039
 tests/test_09_distributed_autoagent.py,sha256=sg5KpHdiYyqQpKAPLNrjkaH4Ur6N8rwYrhbgiCe_KH8,20328
 tests/test_10_distributed_customagent.py,sha256=ZtmZYHPHvW6wPdt3lveixSPm6GO1Fm3v6TCdox6YI6c,29728
-tests/test_13_dx_improvements.py,sha256=rhmTFResVBAx3Vz-C0HDkt1E6tOAUS2GuQG9SRy1HIQ,20332
+tests/test_13_dx_improvements.py,sha256=t3xoWdRBq5o2j90i-kZCJYc9AwW9F0lsB-9Y4VhISiI,20301
 tests/test_14_cloud_deployment.py,sha256=EaqJ9Cai9Ki61dhmeqNgMfEkWGnL8-aQg52CKZ6335I,16402
-tests/test_15_llm_cognitive_discovery.py,sha256=UD0PNDSxQ6yy261yEfq3vf4moYYpQSRs3WI5P-tJ7eo,26381
-tests/test_16_unified_dx_flow.py,sha256=XLLcpvEi40pJMw_7ifsP7udGxnQUIMZ6hvc81DvOuUw,38237
+tests/test_15_llm_cognitive_discovery.py,sha256=AvBtuIPgiI5Z4skpoEjBOP6XwJukAJy7nR08HP-Gl5M,26331
+tests/test_16_unified_dx_flow.py,sha256=fRqIwhXfkioEY1Wri2vNuxUvLYDy4FvwdRkOqAnffXs,38249
+tests/test_17_session_context.py,sha256=8fDdv8Ct3NNgoXgutp2Bk2CJMiN0oCMCqqUhBqyMYds,17018
+tests/test_18_mesh_diagnostics.py,sha256=-8cQMdGC7kgi8Cmafe3odz0wlYbDw17CxsJFJEVNClU,14043
+tests/test_19_async_requests.py,sha256=lCWTdynGHSloY73sH4UYw6xUOkeekYu_HqeUasVVipI,17381
+tests/test_20_load_balancing.py,sha256=a321d8PmwuE5EFN7PBoXol7yJPDtz9IeyjLxuQS_QnM,19573
+tests/test_21_mock_testing.py,sha256=JFvS6a7U8Tsz8GtGYIHBGp0jz_LUL71P6iqD8r_-N88,25469
 tests/test_agent.py,sha256=qx9SFDTP4DlcQi6hV8y6LZyEYX6IB8D3VnM7fODnW9s,5182
 tests/test_autoagent.py,sha256=_mzinLdQwskOn6a-yGqdfoOsqw2f52XSyTCmj8hLqlg,4628
 tests/test_autoagent_day4.py,sha256=TTb0kSImF9stMsq4cMlkGahf9UBpYjoNXAkgnkKuuQA,4719
@@ -140,7 +148,7 @@ tests/test_llm_fallback.py,sha256=CNajpKkQ6MO503dRbgaP2cz9kXHwUGKo5381tHKTe4c,57
 tests/test_mesh.py,sha256=JmAAvZaduQ8dHThFDBYgUnjiz8a3r4Kt1atvdH1JO5I,11857
 tests/test_p2p_integration.py,sha256=F9B21eWlwRzSRphm2Kacs9nM1FgSbSzi6RSLPDvvt2U,10995
 tests/test_remote_sandbox.py,sha256=80ebc0pWInauWnywsQ0VSzlk8OexSCgGL7BcJUCPkR8,3268
-jarviscore_framework-0.3.0.dist-info/METADATA,sha256=W1VITOJ59DKyADAX-GWifmhKzrgfCCwOJqWFHehKyuU,5945
-jarviscore_framework-0.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-jarviscore_framework-0.3.0.dist-info/top_level.txt,sha256=aTco8nlqDftlvhB43Je0xXmb-Pw5qYgj-phawjHX4VY,36
-jarviscore_framework-0.3.0.dist-info/RECORD,,
+jarviscore_framework-0.3.2.dist-info/METADATA,sha256=AOWvJ2tgtGxED2sKHjX2AsNsfk-kbhqDS-gZ7KiWBcs,5876
+jarviscore_framework-0.3.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+jarviscore_framework-0.3.2.dist-info/top_level.txt,sha256=aTco8nlqDftlvhB43Je0xXmb-Pw5qYgj-phawjHX4VY,36
+jarviscore_framework-0.3.2.dist-info/RECORD,,

tests/test_13_dx_improvements.py

@@ -1,9 +1,9 @@
 """
-Test 13: DX Improvements - FastAPI Integration, ListenerAgent, Cognitive Context
+Test 13: DX Improvements - FastAPI Integration, CustomAgent Handlers, Cognitive Context
 
 Tests the Developer Experience improvements:
 - JarvisLifespan for FastAPI integration
-- ListenerAgent profile for API-first agents
+- CustomAgent profile with P2P message handlers
 - Cognitive context generation for LLM prompts
 
 Run with: pytest tests/test_13_dx_improvements.py -v -s
@@ -127,22 +127,22 @@ class TestJarvisLifespan:
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
-# TEST: LISTENER AGENT PROFILE
+# TEST: CUSTOMAGENT P2P HANDLERS
 # ═══════════════════════════════════════════════════════════════════════════════
 
-class TestListenerAgent:
-    """Test ListenerAgent profile."""
+class TestCustomAgentHandlers:
+    """Test CustomAgent P2P message handlers."""
 
     @pytest.mark.asyncio
-    async def test_listener_dispatches_request_to_handler(self):
-        """Test ListenerAgent dispatches REQUEST messages to on_peer_request."""
-        from jarviscore.profiles import ListenerAgent
+    async def test_customagent_dispatches_request_to_handler(self):
+        """Test CustomAgent dispatches REQUEST messages to on_peer_request."""
+        from jarviscore.profiles import CustomAgent
         from jarviscore.p2p.messages import IncomingMessage, MessageType
 
         request_received = False
         request_data = None
 
-        class TestListener(ListenerAgent):
+        class TestAgent(CustomAgent):
             role = "listener"
             capabilities = ["listening"]
 
@@ -152,7 +152,7 @@ class TestListenerAgent:
                 request_data = msg.data
                 return {"handled": True, "echo": msg.data.get("value")}
 
-        agent = TestListener()
+        agent = TestAgent()
         agent._logger = MagicMock()
 
         # Mock peers
@@ -182,15 +182,15 @@ class TestListenerAgent:
         assert call_args[0][1] == {"handled": True, "echo": 42}
 
     @pytest.mark.asyncio
-    async def test_listener_dispatches_notify_to_handler(self):
-        """Test ListenerAgent dispatches NOTIFY messages to on_peer_notify."""
-        from jarviscore.profiles import ListenerAgent
+    async def test_customagent_dispatches_notify_to_handler(self):
+        """Test CustomAgent dispatches NOTIFY messages to on_peer_notify."""
+        from jarviscore.profiles import CustomAgent
         from jarviscore.p2p.messages import IncomingMessage, MessageType
 
         notify_received = False
         notify_data = None
 
-        class TestListener(ListenerAgent):
+        class TestAgent(CustomAgent):
             role = "listener"
             capabilities = ["listening"]
 
@@ -202,7 +202,7 @@ class TestListenerAgent:
                 notify_received = True
                 notify_data = msg.data
 
-        agent = TestListener()
+        agent = TestAgent()
         agent._logger = MagicMock()
 
         # Create test notify message
@@ -221,12 +221,12 @@ class TestListenerAgent:
         assert notify_data == {"event": "task_complete", "result": "success"}
 
     @pytest.mark.asyncio
-    async def test_listener_auto_respond_disabled(self):
-        """Test ListenerAgent respects auto_respond=False setting."""
-        from jarviscore.profiles import ListenerAgent
+    async def test_customagent_auto_respond_disabled(self):
+        """Test CustomAgent respects auto_respond=False setting."""
+        from jarviscore.profiles import CustomAgent
         from jarviscore.p2p.messages import IncomingMessage, MessageType
 
-        class TestListener(ListenerAgent):
+        class TestAgent(CustomAgent):
             role = "listener"
             capabilities = ["listening"]
             auto_respond = False  # Disable auto response
@@ -234,7 +234,7 @@ class TestListenerAgent:
             async def on_peer_request(self, msg):
                 return {"result": "this should not be sent automatically"}
 
-        agent = TestListener()
+        agent = TestAgent()
         agent._logger = MagicMock()
         agent.peers = MagicMock()
         agent.peers.respond = AsyncMock()
@@ -254,15 +254,15 @@ class TestListenerAgent:
         agent.peers.respond.assert_not_called()
 
     @pytest.mark.asyncio
-    async def test_listener_error_handling(self):
-        """Test ListenerAgent calls on_error when handler raises exception."""
-        from jarviscore.profiles import ListenerAgent
+    async def test_customagent_error_handling(self):
+        """Test CustomAgent calls on_error when handler raises exception."""
+        from jarviscore.profiles import CustomAgent
         from jarviscore.p2p.messages import IncomingMessage, MessageType
 
         error_received = None
         error_msg = None
 
-        class TestListener(ListenerAgent):
+        class TestAgent(CustomAgent):
             role = "listener"
             capabilities = ["listening"]
 
@@ -274,7 +274,7 @@ class TestListenerAgent:
                 error_received = error
                 error_msg = msg
 
-        agent = TestListener()
+        agent = TestAgent()
         agent._logger = MagicMock()
         agent.peers = MagicMock()
 
@@ -295,11 +295,11 @@ class TestListenerAgent:
         assert error_msg is not None
 
     @pytest.mark.asyncio
-    async def test_listener_workflow_compatibility(self):
-        """Test ListenerAgent.execute_task() delegates to on_peer_request."""
-        from jarviscore.profiles import ListenerAgent
+    async def test_customagent_workflow_compatibility(self):
+        """Test CustomAgent.execute_task() delegates to on_peer_request."""
+        from jarviscore.profiles import CustomAgent
 
-        class TestListener(ListenerAgent):
+        class TestAgent(CustomAgent):
             role = "processor"
             capabilities = ["processing"]
 
@@ -307,7 +307,7 @@ class TestListenerAgent:
                 task = msg.data.get("task", "")
                 return {"processed": task.upper()}
 
-        agent = TestListener()
+        agent = TestAgent()
         agent._logger = MagicMock()
 
         result = await agent.execute_task({"task": "hello world"})
@@ -500,21 +500,21 @@ class TestCognitiveContext:
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
-# TEST: INTEGRATION - ListenerAgent + JarvisLifespan
+# TEST: INTEGRATION - CustomAgent + JarvisLifespan
 # ═══════════════════════════════════════════════════════════════════════════════
 
-class TestListenerAgentWithFastAPI:
-    """Integration test for ListenerAgent with FastAPI lifespan."""
+class TestCustomAgentWithFastAPI:
+    """Integration test for CustomAgent with FastAPI lifespan."""
 
     @pytest.mark.asyncio
-    async def test_listener_agent_in_fastapi_lifespan(self):
-        """Test ListenerAgent works correctly with JarvisLifespan."""
-        from jarviscore.profiles import ListenerAgent
+    async def test_customagent_in_fastapi_lifespan(self):
+        """Test CustomAgent works correctly with JarvisLifespan."""
+        from jarviscore.profiles import CustomAgent
         from jarviscore.integrations.fastapi import JarvisLifespan
 
         messages_received = []
 
-        class APIAgent(ListenerAgent):
+        class APIAgent(CustomAgent):
             role = "api_processor"
             capabilities = ["api_processing"]
             listen_timeout = 0.1  # Fast timeout for test

tests/test_15_llm_cognitive_discovery.py

@@ -201,19 +201,19 @@ class TestCognitiveContextWithRealMesh:
 # TEST: LISTENERAGENT PEER COMMUNICATION
 # ═══════════════════════════════════════════════════════════════════════════════
 
-class TestListenerAgentPeerCommunication:
-    """Test ListenerAgent handles peer requests correctly."""
+class TestCustomAgentPeerCommunication:
+    """Test CustomAgent handles peer requests correctly."""
 
     @pytest.mark.asyncio
-    async def test_listener_agent_receives_and_responds(self):
-        """Test ListenerAgent receives requests and sends responses."""
+    async def test_customagent_receives_and_responds(self):
+        """Test CustomAgent receives requests and sends responses."""
         from jarviscore import Mesh
-        from jarviscore.profiles import ListenerAgent, CustomAgent
+        from jarviscore.profiles import CustomAgent
 
         request_received = False
         request_data = None
 
-        class ResponderAgent(ListenerAgent):
+        class ResponderAgent(CustomAgent):
             role = "responder"
             capabilities = ["responding"]
             listen_timeout = 0.1
@@ -273,9 +273,9 @@ class TestListenerAgentPeerCommunication:
     async def test_cognitive_context_enables_peer_discovery_for_requests(self):
         """Test that cognitive context helps discover correct peer for requests."""
         from jarviscore import Mesh
-        from jarviscore.profiles import ListenerAgent
+        from jarviscore.profiles import CustomAgent
 
-        class AnalystAgent(ListenerAgent):
+        class AnalystAgent(CustomAgent):
             role = "analyst"
             capabilities = ["data_analysis", "statistics"]
             description = "Expert in data analysis"
@@ -285,7 +285,7 @@ class TestListenerAgentPeerCommunication:
                 query = msg.data.get("query", "")
                 return {"analysis": f"Analyzed: {query}", "confidence": 0.9}
 
-        class CoordinatorAgent(ListenerAgent):
+        class CoordinatorAgent(CustomAgent):
             role = "coordinator"
             capabilities = ["coordination"]
             listen_timeout = 0.1
@@ -415,9 +415,9 @@ class TestLLMCognitiveDiscovery:
     async def test_llm_receives_peer_context_in_prompt(self):
         """Test LLM receives and understands peer context."""
         from jarviscore import Mesh
-        from jarviscore.profiles import ListenerAgent
+        from jarviscore.profiles import CustomAgent
 
-        class SpecialistAgent(ListenerAgent):
+        class SpecialistAgent(CustomAgent):
             role = "data_specialist"
             capabilities = ["data_processing", "analytics"]
             description = "Processes and analyzes data"
@@ -464,11 +464,11 @@ class TestLLMCognitiveDiscovery:
     async def test_llm_decides_to_delegate_based_on_context(self):
         """Test LLM autonomously decides to delegate based on peer context."""
         from jarviscore import Mesh
-        from jarviscore.profiles import ListenerAgent
+        from jarviscore.profiles import CustomAgent
 
         delegation_occurred = False
 
-        class AnalystAgent(ListenerAgent):
+        class AnalystAgent(CustomAgent):
             role = "analyst"
             capabilities = ["data_analysis", "statistics", "insights"]
             description = "Expert data analyst"
@@ -482,7 +482,7 @@ class TestLLMCognitiveDiscovery:
                     "insights": ["Positive trend", "Growth accelerating"]
                 }
 
-        class CoordinatorAgent(ListenerAgent):
+        class CoordinatorAgent(CustomAgent):
             role = "coordinator"
             capabilities = ["coordination", "delegation"]
             listen_timeout = 0.1
@@ -577,12 +577,12 @@ class TestEndToEndCognitiveDiscovery:
     async def test_full_flow_without_llm(self):
         """Test complete flow with mock LLM decisions."""
         from jarviscore import Mesh
-        from jarviscore.profiles import ListenerAgent
+        from jarviscore.profiles import CustomAgent
 
         analyst_requests = []
         scout_requests = []
 
-        class AnalystAgent(ListenerAgent):
+        class AnalystAgent(CustomAgent):
             role = "analyst"
             capabilities = ["analysis"]
             listen_timeout = 0.1
@@ -591,7 +591,7 @@ class TestEndToEndCognitiveDiscovery:
                 analyst_requests.append(msg.data)
                 return {"analysis_result": "Data analyzed successfully"}
 
-        class ScoutAgent(ListenerAgent):
+        class ScoutAgent(CustomAgent):
             role = "scout"
             capabilities = ["research"]
             listen_timeout = 0.1
@@ -600,7 +600,7 @@ class TestEndToEndCognitiveDiscovery:
                 scout_requests.append(msg.data)
                 return {"research_result": "Research completed"}
 
-        class OrchestratorAgent(ListenerAgent):
+        class OrchestratorAgent(CustomAgent):
             role = "orchestrator"
             capabilities = ["orchestration"]
             listen_timeout = 0.1

tests/test_16_unified_dx_flow.py

@@ -3,7 +3,7 @@ Test 16: Unified DX Flow - Autonomous Agents with Mesh as Tool
 
 Tests the COMPLETE real-world flow combining all DX improvements:
 1. FastAPI Integration (JarvisLifespan)
-2. ListenerAgent Profile
+2. CustomAgent Profile with P2P Handlers
 3. Cognitive Discovery (get_cognitive_context)
 4. LLM Autonomous Delegation - Each agent has mesh as a TOOL
 5. Peer-to-Peer Communication - No coordinator, any agent can talk to any agent
@@ -85,9 +85,9 @@ requires_llm = pytest.mark.skipif(not llm_is_available(), reason="No valid LLM A
 
 def create_llm_agent_class():
     """Create the LLMAgent base class."""
-    from jarviscore.profiles import ListenerAgent
+    from jarviscore.profiles import CustomAgent
 
-    class LLMAgent(ListenerAgent):
+    class LLMAgent(CustomAgent):
         """
         Base for LLM-powered agents that can discover and delegate to peers.