open-agents-ai 0.103.18 → 0.103.20

package/README.md

@@ -919,6 +919,7 @@ The TUI features an animated multilingual phrase carousel, live metrics bar with
 | `/models` | List all available models |
 | `/endpoint <url>` | Connect to a remote vLLM or OpenAI-compatible API |
 | `/endpoint <url> --auth <key>` | Set endpoint with Bearer auth |
+| `/endpoint <peerId> --auth <key>` | Connect to a libp2p peer via nexus P2P network |
 | **Task Control** | |
 | `/pause` | Pause after current turn finishes (gentle halt) |
 | `/stop` | Kill current inference immediately, save state |
@@ -952,7 +953,11 @@ The TUI features an animated multilingual phrase carousel, live metrics bar with
 | `/secrets set <name> <value>` | Register a secret in the vault |
 | `/secrets list` | List registered secrets (values hidden) |
 | `/secrets import-env` | Auto-import secrets from environment variables |
-| `/expose` | Expose local inference via cloudflared tunnel |
+| `/expose ollama` | Expose local inference via libp2p (default) |
+| `/expose ollama --tunnel` | Expose via cloudflared tunnel |
+| `/expose ollama --full` | Allow full Ollama API access (pull/delete) |
+| `/expose stop` | Stop the expose gateway |
+| `/expose status` | Show expose usage stats |
 | **Metrics & Updates** | |
 | `/cost` | Show token cost breakdown for the current session |
 | `/score` | Show inference capability scorecard (memory, compute, speed, model compatibility) |
@@ -1498,6 +1503,40 @@ Use `/endpoint` in the TUI or pass via CLI:
 
 The agent auto-detects the provider, normalizes the URL (strips `/v1/chat/completions` if pasted), tests connectivity, and saves the configuration. You can paste full endpoint URLs — they'll be cleaned up automatically.
 
+### P2P Inference via libp2p
+
+Expose your local Ollama models to the decentralized nexus network, or consume another peer's models — no port forwarding, DNS, or cloud accounts needed:
+
+```bash
+# Provider: expose local models via libp2p (default transport)
+/expose ollama
+
+# Output shows a copy-pasteable command:
+#   /endpoint 12D3KooWSwaCi1J... --auth 5aJ68QuP...
+
+# Consumer: connect to a remote peer
+/endpoint 12D3KooWSwaCi1JgXp2f2tQNFZFyMPZVcDe8oyTG672n6ELxSgBt --auth 5aJ68QuPxyz
+
+# Fallback: expose via cloudflared tunnel instead
+/expose ollama --tunnel
+
+# Grant full Ollama API access to consumers (pull, delete, etc.)
+/expose ollama --full
+```
+
+Transport: DHT + mDNS + NATS relay + circuit relay. Auth key is auto-generated and required for all requests. System metrics (CPU/GPU/memory) are available to consumers via the `system_metrics` capability. Without `--full`, destructive Ollama API endpoints (`/api/pull`, `/api/delete`, `/api/create`) are blocked.
+
+### Endpoint Cascade Failover
+
+When you've used multiple endpoints, the agent automatically builds a failover cascade. If the primary endpoint fails with transient errors (502, connection refused, timeout), it transparently switches to the next endpoint that has the same model — then periodically probes the primary to return when it recovers:
+
+```
+[cascade] Failover → https://api.groq.com/openai: 2 consecutive failures: fetch failed
+[cascade] Primary recovered: http://localhost:11434
+```
+
+No configuration needed — the cascade is built from your endpoint usage history. Works across local Ollama, cloud providers, and P2P peers.
+
 ## Evaluation Suite
 
 46 evaluation tasks test the agent's autonomous capabilities across coding, web research, SDLC analysis, tool creation, multi-file reasoning, memory systems, and context engineering: