open-agents-ai 0.86.0 → 0.88.0

package/README.md

@@ -66,7 +66,7 @@ D8AgCTrxpDKD5meJ2bpAfVwcST3NF3EPuy9xczYycnXn
 - **OpenCode delegation** — offload coding tasks to opencode (sst/opencode) as an autonomous sub-agent with auto-install, progress monitoring, and result evaluation
 - **Long-horizon cron agents** — schedule recurring autonomous agent tasks with goals, completion criteria, execution history, and automatic evaluation (daily code reviews, weekly dep updates, continuous monitoring)
 - **Nexus P2P networking** — decentralized agent-to-agent communication via [open-agents-nexus](https://www.npmjs.com/package/open-agents-nexus). Join rooms, discover peers, share resources, and communicate across the agent mesh with encrypted P2P transport
-- **x402 micropayments** — agents can register inference services with USDC pricing on Base network, create secure wallets (AES-256-GCM encrypted, keys never exposed to LLM context), and participate in paid inference markets
+- **x402 micropayments** — native x402 payment rails via open-agents-nexus@1.5.6. Agents create secp256k1/EVM wallets (AES-256-GCM encrypted, keys never exposed to LLM), register inference with USDC pricing on Base, auto-handle `payment_required`/`payment_proof` negotiation, track earnings/spending in ledger.jsonl, enforce budget policies, and sign gasless EIP-3009 transfers
 - **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)
@@ -926,7 +926,7 @@ The steering sub-agent uses the same model and backend as the main agent with `m
 - **LATS** (Zhou et al., 2024) — mid-execution replanning with user-provided value signals improves task completion on complex multi-step problems
 - **AutoGen** (Wu et al., 2023) — human-in-the-loop patterns work best when user messages are expanded into structured instructions, reducing ambiguity for the primary agent
 
-## Tools (47)
+## Tools (54)
 
 | Tool | Description |
 |------|-------------|
@@ -994,6 +994,14 @@ The steering sub-agent uses the same model and backend as the main agent with `m
 | `aiwg_setup` | Deploy AIWG SDLC framework |
 | `aiwg_health` | Analyze project SDLC health and readiness |
 | `aiwg_workflow` | Execute AIWG commands and workflows |
+| **Nexus P2P & x402 Payments** | |
+| `nexus` | Decentralized agent networking — connect, rooms, DMs, peer discovery, invoke capabilities, metering, trust/blocking, IPFS storage |
+| `nexus:expose` | Expose local Ollama models as metered inference capabilities with OpenRouter-based pricing |
+| `nexus:wallet_create` | Generate secp256k1/EVM wallet (Base mainnet USDC) with AES-256-GCM encryption + x402-wallet.key |
+| `nexus:spend` | Sign EIP-3009 USDC TransferWithAuthorization — budget-checked, gasless for payer |
+| `nexus:remote_infer` | Route inference to a remote peer's model — auto-discovers peers, budget-checks, invokes, returns result |
+| `nexus:ledger_status` | Transaction history (earned/spent/pending USDC) |
+| `nexus:budget_set` | Configure spending limits — daily cap, per-invoke max, auto-approve threshold |
 
 Read-only tools execute concurrently when called in the same turn. Mutating tools run sequentially.
 
@@ -1045,6 +1053,63 @@ All context-dependent values scale automatically with the actual context window
 | Tool output cap | 2K-8K chars (scales with context) |
 | File read limits | 80-120 line cap for small/medium context windows |
 
+## x402 Payment Rails & Nexus P2P
+
+Agents can earn and spend USDC on Base mainnet through the native x402 protocol built into [open-agents-nexus@1.5.6](https://www.npmjs.com/package/open-agents-nexus).
+
+### Wallet & Identity
+```
+nexus(action='wallet_create')                          # Generate secp256k1/EVM wallet
+nexus(action='wallet_status')                          # Address, balance, ledger summary
+```
+Creates `wallet.enc` (AES-256-GCM encrypted) and `x402-wallet.key` (plaintext, 0600 perms for daemon x402 module). Keys never enter LLM context.
+
+### Expose Inference with Pricing
+```
+nexus(action='expose', margin='0.5')                   # 50% of OpenRouter market rate
+nexus(action='expose', margin='0')                     # Free (self-hosted)
+nexus(action='pricing_menu')                           # Current pricing for exposed models
+```
+When margin > 0, capabilities are registered with USDC pricing metadata. The daemon auto-handles `invoke.payment_required` → `payment_proof` negotiation via x402.
+
+### Spend — Gasless USDC Transfers (EIP-3009)
+```
+nexus(action='spend', target_address='0x...', amount_usdc='0.10')
+```
+Signs an EIP-3009 `TransferWithAuthorization`. Budget-checked before signing. The recipient (or any facilitator) submits on-chain — no gas needed from the payer. Proof saved to `.oa/nexus/pending-transfer.json`.
+
+### Remote Inference — Tap Into the Mesh
+```
+nexus(action='remote_infer', model='qwen3.5:70b', prompt='Complex analysis task...')
+nexus(action='remote_infer', model='llama3.3:70b', prompt='...', target_peer='12D3KooW...')
+```
+Route a prompt to a remote peer's model on the P2P mesh. Auto-discovers peers that have the requested model exposed, budget-checks the estimated cost, invokes the inference capability, and returns the response. Use `target_peer` to route to a specific provider, or omit for automatic peer selection. Your 8B laptop can seamlessly tap into a 122B model running on the mesh.
+
+### Ledger & Budget
+```
+nexus(action='ledger_status')                          # Earned/spent/pending history
+nexus(action='budget_status')                          # Limits and today's usage
+nexus(action='budget_set', daily_limit='1.00')         # Max daily spend
+nexus(action='budget_set', per_invoke_max='0.10')      # Max per invocation
+nexus(action='budget_set', auto_approve_below='0.01')  # Auto-approve micropayments
+```
+
+### How x402 Works (End to End)
+1. **wallet_create** → generates wallet + x402-wallet.key for daemon signing
+2. **expose** with margin > 0 → registers capabilities with USDC pricing
+3. Peer calls **invoke_capability** → daemon sends `payment_required` with terms
+4. Consumer's daemon auto-signs `payment_proof` → provider validates → invoke proceeds
+5. Metering hook writes payment events to `ledger.jsonl`
+6. **spend** → direct agent-to-agent USDC transfers (EIP-3009, gasless)
+7. **remote_infer** → auto-discover + invoke in one action (budget-checked, with ledger entry)
+
+### Security Model
+- Private keys: AES-256-GCM encrypted in `wallet.enc` (scrypt-derived key)
+- `x402-wallet.key`: plaintext (0600 perms) — used only by daemon subprocess
+- Budget policy: daily limits, per-invoke caps, circuit breaker, peer denylist
+- All outbound messages scanned for key material before sending
+- Keys NEVER appear in tool output, logs, or LLM context
+
 ## Voice Feedback (TTS)
 
 ```bash