agentbnb 9.2.1 → 9.2.2

package/dist/cli/index.js

@@ -931,7 +931,7 @@ function renderReport(report, jsonMode) {
 
 // src/cli/index.ts
 var REGISTRY_HTTP_BUDGET_MS = 5e3;
-var VERSION = true ? "9.2.1" : "0.0.0-dev";
+var VERSION = true ? "9.2.2" : "0.0.0-dev";
 function loadIdentityAuth(owner) {
   const configDir = getConfigDir();
   let keys;
@@ -2501,7 +2501,7 @@ program.command("doctor").description("Validate provider readiness \u2014 setup,
   await runDoctor(opts);
 });
 program.command("mcp-server").description("Start an MCP (Model Context Protocol) server for IDE integration").action(async () => {
-  const { startMcpServer } = await import("../server-LNT4YQZ7.js");
+  const { startMcpServer } = await import("../server-4TACULIV.js");
   await startMcpServer();
 });
 await program.parseAsync(process.argv);

package/dist/{server-LNT4YQZ7.js → server-4TACULIV.js}

@@ -265,7 +265,7 @@ function registerPublishTool(server, ctx) {
 }
 
 // src/mcp/server.ts
-var VERSION = true ? "9.2.1" : "0.0.0-dev";
+var VERSION = true ? "9.2.2" : "0.0.0-dev";
 async function startMcpServer() {
   const config = loadConfig();
   if (!config) {

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "agentbnb",
   "name": "AgentBnB",
-  "description": "Where AI agents hire AI agents — join the network, hire agent specialists, earn credits, and coordinate with peers. Agents run autonomously on their own will.",
-  "version": "8.2.0",
+  "description": "P2P capability sharing protocol for AI agents. Discover, rent, and share skills on a live network with credit-based escrow, Ed25519 identity, and UCAN authorization. 1,700+ tests, MIT license.",
+  "version": "9.2.2",
   "kind": "tools",
   "configSchema": {
     "type": "object",
@@ -14,7 +14,7 @@
       },
       "registry": {
         "type": "string",
-        "default": "https://hub.agentbnb.dev",
+        "default": "https://agentbnb.fly.dev",
         "description": "Registry URL for the AgentBnB network"
       },
       "tier1Threshold": {
@@ -26,6 +26,22 @@
         "type": "number",
         "default": 50,
         "description": "Max credits per call for notify-after-action"
+      },
+      "sessionBudget": {
+        "type": "number",
+        "default": 50,
+        "description": "Max cumulative credits per MCP session (consumer autonomy guard)"
+      },
+      "singleRequestMax": {
+        "type": "number",
+        "default": 20,
+        "description": "Max credits per single request (consumer autonomy guard)"
+      },
+      "multiSkillPolicy": {
+        "type": "string",
+        "enum": ["auto", "notify", "block"],
+        "default": "notify",
+        "description": "Policy for subsequent paid skill calls: auto (allow), notify (warn), block (reject)"
       }
     }
   },
@@ -37,8 +53,8 @@
     },
     "registry": {
       "label": "Registry URL",
-      "placeholder": "https://hub.agentbnb.dev",
-      "help": "AgentBnB public registry. Change only if self-hosting."
+      "placeholder": "https://agentbnb.fly.dev",
+      "help": "AgentBnB public registry and relay. Change only if self-hosting."
     },
     "tier1Threshold": {
       "label": "Tier 1 Threshold (credits)",
@@ -49,6 +65,21 @@
       "label": "Tier 2 Threshold (credits)",
       "help": "Actions below this cost notify after completion. Above = ask before acting.",
       "advanced": true
+    },
+    "sessionBudget": {
+      "label": "Session Budget (credits)",
+      "help": "Max credits an agent can spend in a single MCP session. Prevents runaway multi-skill spending.",
+      "advanced": true
+    },
+    "singleRequestMax": {
+      "label": "Single Request Max (credits)",
+      "help": "Max credits per individual request. Requests above this are blocked.",
+      "advanced": true
+    },
+    "multiSkillPolicy": {
+      "label": "Multi-Skill Policy",
+      "help": "What happens when a second paid skill is called in the same session. 'notify' adds a spend warning.",
+      "advanced": true
     }
   }
 }

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "9.2.1",
+  "version": "9.2.2",
   "description": "P2P Agent Capability Sharing Protocol — Airbnb for AI agent pipelines",
   "type": "module",
   "main": "dist/index.js",

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