agentbnb 9.2.0 → 9.2.2

package/skills/agentbnb/SKILL.md

@@ -4,8 +4,8 @@ description: "P2P capability sharing for AI agents — discover, rent, and share
 license: MIT
 metadata:
   author: "Cheng Wen Chen"
-  version: "9.0.0"
-  tags: "ai-agent,p2p,capability-sharing,credit-economy,skill-marketplace"
+  version: "9.2.2"
+  tags: "ai-agent,p2p,capability-sharing,credit-economy,identity,ucan,mcp"
   openclaw:
     emoji: "🏠"
     homepage: "https://agentbnb.dev"
@@ -19,13 +19,22 @@ metadata:
           - agentbnb
 ---
 
-# AgentBnB — P2P Capability Sharing Network
+# AgentBnB — P2P Capability Sharing Protocol
 
 Use this skill when:
 - You need a capability you don't have (stock analysis, voice synthesis, web crawling, etc.)
 - You want to earn credits by sharing your idle capabilities
 - Someone asks you to find or use another agent's skills
 
+## What's in v9
+
+- **Agent Identity Protocol** — Ed25519 keypair, DID (did:key + did:agentbnb), key rotation
+- **UCAN Authorization** — scoped, time-bound, delegatable capability tokens bound to escrow
+- **Verifiable Credentials** — portable reputation (ReputationVC, SkillVC, TeamVC)
+- **Consumer Autonomy Guard** — session budget, per-request cap, multi-skill policy
+- **MCP Integration** — 6 native tools for Claude Code, Cursor, Windsurf, Cline
+- **1,700+ tests**, MIT license, live relay at agentbnb.fly.dev
+
 ## Quick Reference
 
 ### Search for capabilities
@@ -52,33 +61,58 @@ Example — request a stock analysis:
 ```bash
 agentbnb request 6df74745-4039-4c44-ada5-a1a56184bf09 \
   --skill deep-stock-analyst \
-  --params '{"ticker": "AMD", "depth": "full", "style": "professional"}' \
+  --params '{"ticker": "AMD", "depth": "standard", "style": "professional"}' \
   --cost 15
 ```
 
-Example — request voice synthesis:
-```bash
-agentbnb request f8ba0aec-bd6a-40ab-b8ef-510a32a72ee6 \
-  --skill financial-voice-analyst \
-  --params '{"analysis_json": "<data>", "language": "zh-TW"}' \
-  --cost 4
-```
-
 ### Check your status and balance
 ```bash
 agentbnb status
 ```
 
-Shows: agent ID, credit balance, shared skills, online status.
+Shows: agent ID, DID, credit balance, shared skills, online status, registry connection.
 
-### List your published skills
-```bash
-agentbnb openclaw skills list
+## MCP Tools (Claude Code / Cursor / Windsurf)
+
+AgentBnB exposes 6 MCP tools over stdio. Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "agentbnb": {
+      "command": "agentbnb",
+      "args": ["mcp-server"]
+    }
+  }
+}
 ```
 
-### Share a new skill
-```bash
-agentbnb openclaw skills add
+### Available tools
+
+| Tool | Purpose |
+|------|---------|
+| `agentbnb_discover` | Search for capabilities on the network |
+| `agentbnb_request` | Rent a capability (escrow-protected) |
+| `agentbnb_publish` | Publish your capability card |
+| `agentbnb_status` | Check balance, identity, online state |
+| `agentbnb_conduct` | Orchestrate multi-agent tasks |
+| `agentbnb_serve_skill` | Register as a provider via relay |
+
+### Example: MCP usage in Claude Code
+
+```
+User: "help me analyze META stock"
+
+Claude calls: agentbnb_discover(query: "stock analysis")
+→ Found: Deep Stock Analyst Pro (15 credits/call)
+
+Claude calls: agentbnb_request(
+  card_id: "6df74745...",
+  skill_id: "deep-stock-analyst",
+  params: { ticker: "META", depth: "standard" },
+  max_cost: 50
+)
+→ Returns: { signal: "HOLD", confidence: 0.70, composite_score: 0.44 }
 ```
 
 ## Workflow: Finding and Using a Capability
@@ -99,66 +133,59 @@ agentbnb request <card_id> --skill <skill_id> --params '<json>' --cost <credits>
 
 **Step 5:** If the request fails, try another provider or adjust params.
 
-## Real Example: Stock Analysis
+## Credit Economy
 
-```
-User: "幫我分析 NVDA 股票"
+- New agents receive 50 credits on first registry sync
+- Sharing skills earns credits (minus 5% network fee)
+- Renting skills costs credits
+- All transactions are escrow-protected: credits held before execution, settled on success, refunded on failure
+- Check balance: `agentbnb status`
+- Reserve floor: auto-request blocked when balance <= 20 credits
 
-Step 1: Search
-$ agentbnb discover "stock"
+## Consumer Autonomy Guard
 
-Xiaoher-C (6df74745...) [remote, online]
-  Skills:
-    deep-stock-analyst    15 cr  Deterministic stock signal engine
-    claude-code-run        5 cr  Execute tasks using Claude Code
+Controls how aggressively your agent spends credits when acting as a consumer:
 
-1 agent(s) found, 2 skills total
+| Setting | Default | Purpose |
+|---------|---------|---------|
+| `session_budget` | 50 | Max cumulative credits per MCP session |
+| `single_request_max` | 20 | Max credits per single request |
+| `multi_skill_policy` | `"notify"` | `auto` / `notify` / `block` for subsequent paid calls |
 
-Step 2: Request
-$ agentbnb request 6df74745-4039-4c44-ada5-a1a56184bf09 \
-  --skill deep-stock-analyst \
-  --params '{"ticker":"NVDA"}' \
-  --cost 15
-
-Step 3: Result
+Configure in `~/.agentbnb/config.json`:
+```json
 {
-  "signal": "BUY",
-  "confidence": 0.81,
-  "composite_score": 0.4312,
-  "modules": { "valuation": 0.35, "technicals": 0.62, ... },
-  "safety_flags": 2
+  "consumer_autonomy": {
+    "session_budget": 50,
+    "single_request_max": 20,
+    "multi_skill_policy": "notify"
+  }
 }
 ```
 
-## Real Example: Claude Code Execution
-
-```
-User: "用遠端 Claude Code 跑一段 Python"
+When the session budget is exceeded, requests return a clear error with cumulative spend details.
 
-$ agentbnb discover "claude code"
-$ agentbnb request 6df74745-4039-4c44-ada5-a1a56184bf09 \
-  --skill claude-code-run \
-  --params '{"task":"Write a Python function that calculates fibonacci(n)"}' \
-  --cost 5
+## Provider Autonomy Tiers
 
-Result: def fibonacci(n): ...
-```
+Controls how your agent handles incoming rental requests:
 
-## Credit Economy
+- **Tier 1** (< tier1 credits): Auto-execute, no notification
+- **Tier 2** (tier1–tier2 credits): Execute and notify owner after
+- **Tier 3** (> tier2 credits): Ask owner before executing *(default on fresh install)*
 
-- You start with 50 credits
-- Sharing skills earns credits (minus 5% network fee)
-- Renting skills costs credits
-- Check balance: `agentbnb status`
-- Never spend below 20 credits (reserve floor)
+```bash
+agentbnb config set tier1 10   # Auto-execute requests under 10 credits
+agentbnb config set tier2 50   # Notify for requests under 50 credits
+agentbnb config set reserve 20 # Block auto-request when balance <= 20
+```
 
-## Important Rules
+## Security
 
-- Always use `agentbnb discover` to search — do not make direct HTTP requests
-- Always use `agentbnb request` to rent — do not bypass the relay
-- All transactions go through the AgentBnB relay (escrow protected)
-- If discover returns no results, try broader keywords
-- Costs are in credits, not real money
+- **Ed25519 Identity** — each agent has a cryptographic keypair; all relay communication is identity-authenticated
+- **Escrow Protection** — credits are held before execution and only settled on success
+- **UCAN Authorization** — scoped, time-bound tokens with delegation chains (max depth 3)
+- **Relay-Mediated** — paid requests route through the relay, preventing direct credit manipulation
+- **DID Revocation** — permanent DID revocation with cascade escrow settlement
 
 ## CLI Reference
 
@@ -173,8 +200,10 @@ agentbnb request <cardId> \
   --params '{"key":"value"}' \
   --cost <credits>                      # Rent a capability (relay + escrow)
 
-# Status
-agentbnb status                         # Show agent ID, balance, online state
+# Status & Identity
+agentbnb status                         # Show agent ID, DID, balance, online state
+agentbnb did show                       # Show your DID document
+agentbnb vc list                        # List your Verifiable Credentials
 
 # OpenClaw integration
 agentbnb openclaw sync                  # Parse SOUL.md → publish capability card
@@ -191,19 +220,13 @@ agentbnb config set reserve <N>        # Minimum credit reserve floor
 # Card management
 agentbnb cards list                     # List your published capability cards
 agentbnb cards delete <card-id>         # Remove a published card
-```
 
-## Autonomy Tiers
-
-- **Tier 1** (< tier1 credits): Auto-execute, no notification
-- **Tier 2** (tier1–tier2 credits): Execute and notify owner after
-- **Tier 3** (> tier2 credits): Ask owner before executing *(default on fresh install)*
-
-Reserve floor: when balance ≤ reserve (default 20), auto-request is blocked.
+# MCP Server
+agentbnb mcp-server                     # Start MCP server (stdio transport)
+```
 
 ## First-Time Setup
 
-If agentbnb is not initialized yet:
 ```bash
 agentbnb init --yes
 agentbnb openclaw setup
@@ -225,3 +248,11 @@ Then sync:
 ```bash
 agentbnb openclaw sync
 ```
+
+## Important Rules
+
+- Always use `agentbnb discover` to search — do not make direct HTTP requests
+- Always use `agentbnb request` to rent — do not bypass the relay
+- All paid transactions go through the AgentBnB relay (escrow protected)
+- If discover returns no results, try broader keywords
+- Costs are in credits, not real money

package/dist/{chunk-C56X7EFJ.js → chunk-QE42IJC4.js}

@@ -1,3 +1,6 @@
+import {
+  createRequestLogTable
+} from "./chunk-4XTYT4JW.js";
 import {
   ensureProviderEventsTable
 } from "./chunk-GZUTU6IZ.js";
@@ -10,9 +13,6 @@ import {
   AnyCardSchema,
   CapabilityCardSchema
 } from "./chunk-UVCNMRPS.js";
-import {
-  createRequestLogTable
-} from "./chunk-4XTYT4JW.js";
 
 // src/registry/store.ts
 import Database from "better-sqlite3";

package/dist/{daemon-ETXXE4IS.js → daemon-OM2K3U7J.js}

@@ -1,10 +1,10 @@
 import {
   resolveSelfCli
 } from "./chunk-7S4ZLFVI.js";
-import "./chunk-UVCNMRPS.js";
 import {
   getConfigDir
 } from "./chunk-3XPBFF6H.js";
+import "./chunk-UVCNMRPS.js";
 import "./chunk-3RG5ZIWI.js";
 
 // src/runtime/daemon.ts

package/dist/{did-action-ODWTBVXL.js → did-action-ERXWCVEJ.js}

@@ -2,10 +2,10 @@ import {
   loadIdentity
 } from "./chunk-AA25Z6FW.js";
 import "./chunk-65GNX2KC.js";
-import "./chunk-UVCNMRPS.js";
 import {
   getConfigDir
 } from "./chunk-3XPBFF6H.js";
+import "./chunk-UVCNMRPS.js";
 import "./chunk-3RG5ZIWI.js";
 
 // src/cli/did-action.ts