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

jarviscore/docs/CHANGELOG.md

@@ -7,6 +7,137 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.3.2] - 2026-02-03
+
+### Added
+
+#### Session Context Propagation
+- Added `context` parameter to `notify()`, `request()`, `respond()`, and `broadcast()` methods
+- Context carries metadata like mission_id, priority, trace_id across message flows
+- `respond()` automatically propagates context from request if not overridden
+- `IncomingMessage.context` accessible in all message handlers
+
+```python
+# Send request with context
+response = await peers.request("analyst", {"q": "..."}, context={"mission_id": "abc"})
+
+# Access context in handler
+async def on_peer_request(self, msg):
+    mission_id = msg.context.get("mission_id")  # Available!
+    return {"result": "..."}
+```
+
+#### Mesh Diagnostics
+- Added `mesh.get_diagnostics()` method for mesh health monitoring
+- Returns: `local_node`, `known_peers`, `local_agents`, `connectivity_status`
+- Connectivity status values: `healthy`, `isolated`, `degraded`, `not_started`, `local_only`
+- Includes SWIM and keepalive status when P2P is enabled
+
+```python
+diag = mesh.get_diagnostics()
+print(diag["connectivity_status"])  # "healthy", "isolated", etc.
+```
+
+#### Async Request Pattern
+- Added `ask_async(target, message, timeout, context)` - returns request_id immediately
+- Added `check_inbox(request_id, timeout, remove)` - returns response or None
+- Added `get_pending_async_requests()` - list pending async requests
+- Added `clear_inbox(request_id)` - clear specific or all inbox entries
+
+```python
+# Fire off multiple requests
+req_ids = [await peers.ask_async(a, {"q": "..."}) for a in analysts]
+
+# Do other work...
+await process_other_tasks()
+
+# Collect responses later
+for req_id in req_ids:
+    response = await peers.check_inbox(req_id, timeout=5)
+```
+
+#### Load Balancing Strategies
+- Added `strategy` parameter to `discover()`: `"first"`, `"random"`, `"round_robin"`, `"least_recent"`
+- Added `discover_one()` convenience method for single peer lookup
+- Added `record_peer_usage(peer_id)` for least_recent tracking
+
+```python
+# Round-robin across workers
+worker = peers.discover_one(role="worker", strategy="round_robin")
+
+# Least recently used analyst
+analyst = peers.discover_one(role="analyst", strategy="least_recent")
+```
+
+#### MockMesh Testing Utilities
+- Created `jarviscore.testing` module
+- `MockPeerClient`: Full mock with discovery, messaging, assertion helpers
+- `MockMesh`: Simplified mesh without real P2P infrastructure
+- Auto-injects MockPeerClient into agents during MockMesh.start()
+
+```python
+from jarviscore.testing import MockMesh, MockPeerClient
+
+mesh = MockMesh()
+mesh.add(MyAgent)
+await mesh.start()
+
+agent = mesh.get_agent("my_role")
+agent.peers.set_mock_response("analyst", {"result": "test"})
+agent.peers.assert_requested("analyst")
+```
+
+### Testing
+- Session context propagation through all messaging methods
+- Mesh diagnostics structure and connectivity status values
+- Async request/response flow with check_inbox
+- Load balancing strategies (first, random, round_robin, least_recent)
+- MockMesh and MockPeerClient functionality and assertion helpers
+
+---
+
+## [0.3.1] - 2026-02-02
+
+### Breaking Changes
+
+#### ListenerAgent Removed
+- **ListenerAgent has been merged into CustomAgent**
+- Migration is simple - just change the import:
+  ```python
+  # Before
+  from jarviscore.profiles import ListenerAgent
+  class MyAgent(ListenerAgent): ...
+
+  # After
+  from jarviscore.profiles import CustomAgent
+  class MyAgent(CustomAgent): ...
+  ```
+- All handler methods work exactly the same way
+- No other code changes required
+
+### Changed
+
+#### CustomAgent Now Includes P2P Handlers
+- `on_peer_request(msg)` - Handle incoming requests (return value sent as response)
+- `on_peer_notify(msg)` - Handle fire-and-forget notifications
+- `on_error(error, msg)` - Handle errors during message processing
+- `run()` - Built-in listener loop (no need to write your own)
+- Configuration: `listen_timeout`, `auto_respond`
+
+#### Simplified Profile Architecture
+| Before (v0.3.0) | After (v0.3.1) |
+|-----------------|----------------|
+| AutoAgent + CustomAgent + ListenerAgent | AutoAgent + CustomAgent |
+| "Which profile do I use?" confusion | Clear: AutoAgent (LLM) or CustomAgent (your code) |
+
+### Documentation
+- README.md updated with unified CustomAgent examples
+- GETTING_STARTED.md rewritten with framework integration patterns
+- CUSTOMAGENT_GUIDE.md updated (ListenerAgent sections removed)
+- Added async-first framework guidance (FastAPI, aiohttp, Flask patterns)
+
+---
+
 ## [0.3.0] - 2026-01-29
 
 ### Added

jarviscore/docs/CONFIGURATION.md

@@ -766,6 +766,6 @@ LOG_DIRECTORY=/tmp/jarviscore-logs
 
 ## Version
 
-Configuration Guide for JarvisCore v0.2.1
+Configuration Guide for JarvisCore v0.3.2
 
 Last Updated: 2026-01-23