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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. examples/cloud_deployment_example.py +162 -0
  2. examples/fastapi_integration_example.py +570 -0
  3. examples/listeneragent_cognitive_discovery_example.py +343 -0
  4. jarviscore/__init__.py +22 -5
  5. jarviscore/cli/smoketest.py +8 -4
  6. jarviscore/core/agent.py +227 -0
  7. jarviscore/data/examples/cloud_deployment_example.py +162 -0
  8. jarviscore/data/examples/fastapi_integration_example.py +570 -0
  9. jarviscore/data/examples/listeneragent_cognitive_discovery_example.py +343 -0
  10. jarviscore/docs/API_REFERENCE.md +296 -3
  11. jarviscore/docs/CHANGELOG.md +97 -0
  12. jarviscore/docs/CUSTOMAGENT_GUIDE.md +832 -13
  13. jarviscore/docs/GETTING_STARTED.md +111 -7
  14. jarviscore/docs/USER_GUIDE.md +152 -6
  15. jarviscore/integrations/__init__.py +16 -0
  16. jarviscore/integrations/fastapi.py +247 -0
  17. jarviscore/p2p/broadcaster.py +10 -3
  18. jarviscore/p2p/coordinator.py +310 -14
  19. jarviscore/p2p/keepalive.py +45 -23
  20. jarviscore/p2p/peer_client.py +282 -10
  21. jarviscore/p2p/swim_manager.py +9 -4
  22. jarviscore/profiles/__init__.py +10 -2
  23. jarviscore/profiles/listeneragent.py +292 -0
  24. {jarviscore_framework-0.2.1.dist-info → jarviscore_framework-0.3.0.dist-info}/METADATA +37 -4
  25. {jarviscore_framework-0.2.1.dist-info → jarviscore_framework-0.3.0.dist-info}/RECORD +32 -18
  26. {jarviscore_framework-0.2.1.dist-info → jarviscore_framework-0.3.0.dist-info}/WHEEL +1 -1
  27. tests/test_13_dx_improvements.py +554 -0
  28. tests/test_14_cloud_deployment.py +403 -0
  29. tests/test_15_llm_cognitive_discovery.py +684 -0
  30. tests/test_16_unified_dx_flow.py +947 -0
  31. {jarviscore_framework-0.2.1.dist-info → jarviscore_framework-0.3.0.dist-info}/licenses/LICENSE +0 -0
  32. {jarviscore_framework-0.2.1.dist-info → jarviscore_framework-0.3.0.dist-info}/top_level.txt +0 -0
jarviscore/docs/CHANGELOG.md ADDED
@@ -0,0 +1,97 @@
1
+ # Changelog
2
+
3
+ All notable changes to JarvisCore Framework will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ---
9
+
10
+ ## [0.3.0] - 2026-01-29
11
+
12
+ ### Added
13
+
14
+ #### ListenerAgent Profile
15
+ - New `ListenerAgent` class for handler-based P2P communication
16
+ - `on_peer_request(msg)` handler for incoming requests
17
+ - `on_peer_notify(msg)` handler for broadcast notifications
18
+ - No more manual `run()` loops required for simple P2P agents
19
+
20
+ #### FastAPI Integration
21
+ - `JarvisLifespan` context manager for 3-line FastAPI integration
22
+ - Automatic agent lifecycle management (setup, run, teardown)
23
+ - Support for both `p2p` and `distributed` modes
24
+ - Import: `from jarviscore.integrations.fastapi import JarvisLifespan`
25
+
26
+ #### Cognitive Discovery
27
+ - `peers.get_cognitive_context()` generates LLM-ready peer descriptions
28
+ - Dynamic peer awareness - no more hardcoded agent names in prompts
29
+ - Auto-updates when peers join or leave the mesh
30
+
31
+ #### Cloud Deployment
32
+ - `agent.join_mesh(seed_nodes)` for self-registration without central orchestrator
33
+ - `agent.leave_mesh()` for graceful departure
34
+ - `agent.serve_forever()` for container deployments
35
+ - `RemoteAgentProxy` for automatic cross-node agent visibility
36
+ - Environment variable support:
37
+ - `JARVISCORE_SEED_NODES` - comma-separated seed node addresses
38
+ - `JARVISCORE_MESH_ENDPOINT` - advertised endpoint for this agent
39
+ - `JARVISCORE_BIND_PORT` - P2P port
40
+
41
+ ### Changed
42
+
43
+ - Documentation restructured with before/after comparisons
44
+ - CUSTOMAGENT_GUIDE.md expanded with v0.3.0 features
45
+ - API_REFERENCE.md updated with new classes and methods
46
+
47
+ ### Developer Experience
48
+
49
+ | Before (v0.2.x) | After (v0.3.0) |
50
+ |-----------------|----------------|
51
+ | Manual `run()` loops with `receive()`/`respond()` | `ListenerAgent` with `on_peer_request()` handlers |
52
+ | ~100 lines for FastAPI integration | 3 lines with `JarvisLifespan` |
53
+ | Hardcoded peer names in LLM prompts | Dynamic `get_cognitive_context()` |
54
+ | Central orchestrator required | Self-registration with `join_mesh()` |
55
+
56
+ ---
57
+
58
+ ## [0.2.1] - 2026-01-23
59
+
60
+ ### Fixed
61
+ - P2P message routing stability improvements
62
+ - Workflow engine dependency resolution edge cases
63
+
64
+ ---
65
+
66
+ ## [0.2.0] - 2026-01-15
67
+
68
+ ### Added
69
+ - CustomAgent profile for integrating existing agent code
70
+ - P2P mode for direct agent-to-agent communication
71
+ - Distributed mode combining workflow engine + P2P
72
+ - `@jarvis_agent` decorator for wrapping existing classes
73
+ - `wrap()` function for wrapping existing instances
74
+ - `JarvisContext` for workflow context access
75
+ - Peer tools: `ask_peer`, `broadcast`, `list_peers`
76
+
77
+ ### Changed
78
+ - Mesh now supports three modes: `autonomous`, `p2p`, `distributed`
79
+ - Agent base class now includes P2P support
80
+
81
+ ---
82
+
83
+ ## [0.1.0] - 2026-01-01
84
+
85
+ ### Added
86
+ - Initial release
87
+ - AutoAgent profile with LLM-powered code generation
88
+ - Workflow engine with dependency management
89
+ - Sandbox execution (local and remote)
90
+ - Auto-repair for failed code
91
+ - Internet search integration (DuckDuckGo)
92
+ - Multi-provider LLM support (Claude, OpenAI, Azure, Gemini)
93
+ - Result storage and code registry
94
+
95
+ ---
96
+
97
+ *JarvisCore Framework - Build autonomous AI agents with P2P mesh networking.*