open-agents-ai 0.138.52 → 0.138.56

package/README.md

@@ -1,3 +1,15 @@
+<p align="center">
+<pre align="center">
+  ██████╗  █████╗
+ ██╔═══██╗██╔══██╗    ░▒▓█▓▒░   ░▒▓▓▒░  ░▒▓▓▒░
+ ██║   ██║███████║     ░▒▓█▓▒░▒▓▓▒░▒▓▓▒░▒▓▓▒░
+ ██║   ██║██╔══██║      ░▒▓█▓▒░▒▓▓▒░░▒▓▓▒░
+ ╚██████╔╝██║  ██║       ░▒▓▓▒░▒▓▓▒░▒▓▓▒░
+  ╚═════╝ ╚═╝  ╚═╝        ░▒▓▓▒░░▒▓▓▒░
+  /help  /voice  /cohere  /model
+</pre>
+</p>
+
 <h1 align="center">Open Agents</h1>
 
 <p align="center">
@@ -51,7 +63,7 @@ The agent uses tools autonomously in a loop — reading errors, fixing code, and
 - **Inference capability proof** — benchmark local models with anti-spoofing SHA-256 hashed proofs, generate capability scorecards for peer verification
 - **Ralph Loop** — iterative task execution that keeps retrying until completion criteria are met
 - **Dream Mode** — creative idle exploration modeled after real sleep architecture (NREM→REM cycles)
-- **COHERE Cognitive Stack** — layered cognitive architecture implementing [Recursive Language Models](https://arxiv.org/abs/2512.24601), [SPRINT parallel reasoning](https://arxiv.org/abs/2506.05745), governed memory metabolism, identity kernel with continuity register, immune-system reflection, and [strategy-space exploration](https://arxiv.org/abs/2603.02045). See [COHERE Framework](#cohere-cognitive-framework) below
+- **COHERE Cognitive Stack** — layered cognitive architecture implementing [Recursive Language Models](https://arxiv.org/abs/2512.24601), [SPRINT parallel reasoning](https://arxiv.org/abs/2506.05745), governed memory metabolism, identity kernel with continuity register, immune-system reflection, [strategy-space exploration](https://arxiv.org/abs/2603.02045), and **distributed inference mesh** — any `/cohere` participant automatically serves AND consumes inference from the network with complexity-based model routing, multi-node claim coordination, IPFS-pinned identity persistence, model exposure control, and Ollama safety hardening. See [COHERE Framework](#cohere-cognitive-framework) below
 - **Persistent Python REPL** — `repl_exec` tool maintains variables, imports, and functions across calls. Write Python code that processes data iteratively, with `llm_query()` available for recursive LLM sub-calls from within code
 - **Recursive LLM calls** — `llm_query(prompt, context)` invokes the model from inside REPL code, enabling loop-based semantic analysis of large inputs ([RLM paper](https://arxiv.org/abs/2512.24601)). `parallel_llm_query()` runs multiple calls concurrently ([SPRINT](https://arxiv.org/abs/2506.05745))
 - **Memory metabolism** — governed memory lifecycle: classify (episodic/semantic/procedural/normative), score (novelty/utility/confidence), consolidate lessons from trajectories. Inspired by [TIMG](https://arxiv.org/abs/2603.10600) and [MemMA](https://arxiv.org/abs/2603.18718)
@@ -391,13 +403,43 @@ Open Agents implements the **COHERE layered cognitive stack** — a provenance-g
 ```
 Layer 8: Exploration & Culture (ARCHE) — strategy diversity + variant archiving
 Layer 7: Reflection & Integrity      — immune-system audit (diagnostic/epistemic/constitutional)
-Layer 6: Identity Kernel (COHERE)    — persistent self-state + homeostasis
-Layer 5: Memory Metabolism           — governed write/manage/read lifecycle
+Layer 6: Identity Kernel (COHERE)    — persistent self-state + homeostasis + IPFS snapshots
+Layer 5: Memory Metabolism           — governed write/manage/read lifecycle + decay + auto-promotion
 Layer 4: Shared Workspace            — handle registry + Memex archive
-Layer 3: SPRINT Reasoning            — parallel sub-calls via ThreadPoolExecutor
-Layer 2: RLM Context OS              — persistent REPL + llm_query + externalization
-Layer 1: Inference Mesh              — Nexus P2P + expose gateway
-Layer 0: Voice & Embodiment          — Whisper ASR + neural TTS
+Layer 3: SPRINT Reasoning            — parallel sub-calls + cross-node task dispatch
+Layer 2: RLM Context OS              — persistent REPL + llm_query + session save/restore
+Layer 1: Inference Mesh              — Nexus P2P + expose gateway + COHERE distributed inference
+Layer 0: Voice & Embodiment          — Whisper ASR + neural TTS + stereo ITD
+```
+
+### Distributed Inference (`/cohere`)
+
+Toggle `/cohere` to participate in the **COHERE cognitive commons** — a distributed inference mesh where every participant automatically load-balances each other:
+
+```
+You:     /cohere                          ← toggle on
+Daemon:  COHERE enabled — listening on nexus.cohere.query
+         Capacity announcement: 3 models, warm=qwen3.5:122b
+
+Peer:    "Explain TCP vs UDP" → NATS broadcast
+Your OA: claim → route to qwen3:4b (trivial) → respond in 1.2s
+```
+
+**How it works:**
+- Queries broadcast on NATS `nexus.cohere.query` — any participant can answer
+- **Complexity routing** classifies queries (trivial/moderate/complex) → matches to model size
+- **Claim protocol** prevents wasted compute — first-claim-wins with deterministic tie-breaking
+- **Capacity announcements** every 60s — peers know your models, warm status, and load
+- **Model allowlist** — `/cohere allow qwen3:4b` controls which models are exposed
+- **Ollama safety** — remote queries can ONLY run inference on existing models; `/api/pull`, `/api/delete`, `/api/create` are never called
+- **Identity pinning** — snapshots published to IPFS (Helia) with SHA-256 content addressing; survives daemon restarts
+- **Background daemon** persists across OA restarts (`detached: true` + PID file reconnection)
+
+```bash
+/cohere stats    # Network transparency — queries in/out, model usage, peer activity
+/cohere models   # List models with [EXPOSED]/[HIDDEN] status
+/cohere allow X  # Allow specific model for remote queries
+/cohere deny X   # Hide model from remote queries
 ```
 
 ### How It Works