elo-node 0.4.5__tar.gz → 0.4.6__tar.gz

{elo_node-0.4.5 → elo_node-0.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elo-node
-Version: 0.4.5
+Version: 0.4.6
 Summary: Elo — malha P2P de mensagens para agentes de IA. Zero infraestrutura.
 Author: Elo Contributors
 License: MIT
@@ -35,7 +35,7 @@ import asyncio
 from elo import Node
 
 async def main():
-    node = Node("my-agent", port=7878)
+    node = Node("my-agent", port=7878, peers=["100.91.215.113:7878"])
     await node.connect()
     await node.register(agents=["analyst"], tools=["web-search"])
 
@@ -53,6 +53,7 @@ asyncio.run(main())
 - **Decentralized P2P** — discovery via public tracker or Kademlia DHT
 - **ed25519 signatures** — cryptographic identity, authenticated messages
 - **Capabilities** — publish/subscribe of agent skills across the mesh
+- **Relay via tracker** — nodes behind NAT/Docker can communicate through a tracker
 - **Zero infra** — no Kafka, Redis, NATS, or central server
 - **Native CLI** — `python -m elo serve`, `status`, `init`, `id`
 
@@ -66,26 +67,21 @@ python -m elo init         # Generate persistent identity
 python -m elo serve        # Start an interactive node
 ```
 
-## Architecture
+## Key Concepts
 
-```
-┌──────────────────┐     TCP/JSON     ┌──────────────────┐
-│   Node A          │◄──────────────►│   Node B          │
-│   ed25519 key     │                │   ed25519 key     │
-│   Capabilities    │                │   Capabilities    │
-│   Interests       │                │   Interests       │
-└──────────────────┘                 └──────────────────┘
-         │                                  │
-         │        Tracker (optional)         │
-         └────────────── DHT ───────────────┘
-```
+- **`peers=` is required** for outbound connections. Without it the node only listens.
+- **`send_task()` auto-fallback:** direct → InterestTable → QUERY → **tracker relay** → NO_PEER
+- **HELLO_ACK with known_peers:** tracker shares all peers on handshake (v0.4.4+)
+- **`discover_peers_network()`** — QUERY broadcast across the mesh
+
+## Changelog
 
-Each node:
-1. Generates an ed25519 identity on first run
-2. Listens on a TCP port
-3. Announces capabilities (e.g. "analyst", "web-search")
-4. Discovers other nodes via shared tracker or manual peers
-5. Exchanges signed messages (tasks, results, events)
+| Version | Highlights |
+|---------|------------|
+| 0.4.5 | Multi-response discover, tracker returns all peers on query |
+| 0.4.4 | HELLO_ACK with known_peers, send_task auto-fallback tracker |
+| 0.4.3 | Relay via tracker, send_task_via_tracker() |
+| 0.4.0 | Initial release |
 
 ## Compatibility
 

{elo_node-0.4.5 → elo_node-0.4.6}/README.md

@@ -13,7 +13,7 @@ import asyncio
 from elo import Node
 
 async def main():
-    node = Node("my-agent", port=7878)
+    node = Node("my-agent", port=7878, peers=["100.91.215.113:7878"])
     await node.connect()
     await node.register(agents=["analyst"], tools=["web-search"])
 
@@ -31,6 +31,7 @@ asyncio.run(main())
 - **Decentralized P2P** — discovery via public tracker or Kademlia DHT
 - **ed25519 signatures** — cryptographic identity, authenticated messages
 - **Capabilities** — publish/subscribe of agent skills across the mesh
+- **Relay via tracker** — nodes behind NAT/Docker can communicate through a tracker
 - **Zero infra** — no Kafka, Redis, NATS, or central server
 - **Native CLI** — `python -m elo serve`, `status`, `init`, `id`
 
@@ -44,26 +45,21 @@ python -m elo init         # Generate persistent identity
 python -m elo serve        # Start an interactive node
 ```
 
-## Architecture
+## Key Concepts
 
-```
-┌──────────────────┐     TCP/JSON     ┌──────────────────┐
-│   Node A          │◄──────────────►│   Node B          │
-│   ed25519 key     │                │   ed25519 key     │
-│   Capabilities    │                │   Capabilities    │
-│   Interests       │                │   Interests       │
-└──────────────────┘                 └──────────────────┘
-         │                                  │
-         │        Tracker (optional)         │
-         └────────────── DHT ───────────────┘
-```
+- **`peers=` is required** for outbound connections. Without it the node only listens.
+- **`send_task()` auto-fallback:** direct → InterestTable → QUERY → **tracker relay** → NO_PEER
+- **HELLO_ACK with known_peers:** tracker shares all peers on handshake (v0.4.4+)
+- **`discover_peers_network()`** — QUERY broadcast across the mesh
+
+## Changelog
 
-Each node:
-1. Generates an ed25519 identity on first run
-2. Listens on a TCP port
-3. Announces capabilities (e.g. "analyst", "web-search")
-4. Discovers other nodes via shared tracker or manual peers
-5. Exchanges signed messages (tasks, results, events)
+| Version | Highlights |
+|---------|------------|
+| 0.4.5 | Multi-response discover, tracker returns all peers on query |
+| 0.4.4 | HELLO_ACK with known_peers, send_task auto-fallback tracker |
+| 0.4.3 | Relay via tracker, send_task_via_tracker() |
+| 0.4.0 | Initial release |
 
 ## Compatibility
 

{elo_node-0.4.5 → elo_node-0.4.6}/elo/__init__.py

@@ -26,4 +26,4 @@ __all__ = [
     "Node", "Task", "Result", "Event", "NodeInfo", "Capabilities",
     "EphemeralIdentity", "generate_and_save_identity", "load_identity",
 ]
-__version__ = "0.4.4"
+__version__ = "0.4.6"

{elo_node-0.4.5 → elo_node-0.4.6}/elo/node.py

@@ -78,7 +78,7 @@ class Node:
         peers: list[str] | None = None,
         tracker: str = "public",
         allowlist: list[str] | None = None,
-        version: str = "0.4.5",
+        version: str = "0.4.6",
         identity: EphemeralIdentity | None = None,
         verify_peers: bool = True,
         heartbeat_interval_s: int = 30,

{elo_node-0.4.5 → elo_node-0.4.6}/elo_node.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elo-node
-Version: 0.4.5
+Version: 0.4.6
 Summary: Elo — malha P2P de mensagens para agentes de IA. Zero infraestrutura.
 Author: Elo Contributors
 License: MIT
@@ -35,7 +35,7 @@ import asyncio
 from elo import Node
 
 async def main():
-    node = Node("my-agent", port=7878)
+    node = Node("my-agent", port=7878, peers=["100.91.215.113:7878"])
     await node.connect()
     await node.register(agents=["analyst"], tools=["web-search"])
 
@@ -53,6 +53,7 @@ asyncio.run(main())
 - **Decentralized P2P** — discovery via public tracker or Kademlia DHT
 - **ed25519 signatures** — cryptographic identity, authenticated messages
 - **Capabilities** — publish/subscribe of agent skills across the mesh
+- **Relay via tracker** — nodes behind NAT/Docker can communicate through a tracker
 - **Zero infra** — no Kafka, Redis, NATS, or central server
 - **Native CLI** — `python -m elo serve`, `status`, `init`, `id`
 
@@ -66,26 +67,21 @@ python -m elo init         # Generate persistent identity
 python -m elo serve        # Start an interactive node
 ```
 
-## Architecture
+## Key Concepts
 
-```
-┌──────────────────┐     TCP/JSON     ┌──────────────────┐
-│   Node A          │◄──────────────►│   Node B          │
-│   ed25519 key     │                │   ed25519 key     │
-│   Capabilities    │                │   Capabilities    │
-│   Interests       │                │   Interests       │
-└──────────────────┘                 └──────────────────┘
-         │                                  │
-         │        Tracker (optional)         │
-         └────────────── DHT ───────────────┘
-```
+- **`peers=` is required** for outbound connections. Without it the node only listens.
+- **`send_task()` auto-fallback:** direct → InterestTable → QUERY → **tracker relay** → NO_PEER
+- **HELLO_ACK with known_peers:** tracker shares all peers on handshake (v0.4.4+)
+- **`discover_peers_network()`** — QUERY broadcast across the mesh
+
+## Changelog
 
-Each node:
-1. Generates an ed25519 identity on first run
-2. Listens on a TCP port
-3. Announces capabilities (e.g. "analyst", "web-search")
-4. Discovers other nodes via shared tracker or manual peers
-5. Exchanges signed messages (tasks, results, events)
+| Version | Highlights |
+|---------|------------|
+| 0.4.5 | Multi-response discover, tracker returns all peers on query |
+| 0.4.4 | HELLO_ACK with known_peers, send_task auto-fallback tracker |
+| 0.4.3 | Relay via tracker, send_task_via_tracker() |
+| 0.4.0 | Initial release |
 
 ## Compatibility
 

{elo_node-0.4.5 → elo_node-0.4.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "elo-node"
-version = "0.4.5"
+version = "0.4.6"
 description = "Elo — malha P2P de mensagens para agentes de IA. Zero infraestrutura."
 readme = "README.md"
 license = {text = "MIT"}

{elo_node-0.4.5 → elo_node-0.4.6}/tests/test_unit.py

@@ -136,7 +136,7 @@ class TestNodeConstruction:
         node = Node("test-node")
         assert node._name == "test-node"
         assert node._port == 7878
-        assert node._version == "0.4.4"
+        assert node._version == "0.4.6"
         assert node.connected is False
         assert node.node_id is not None
         assert len(node.node_id) > 20