agentbnb 8.4.4 → 8.4.7

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "8.4.4",
+  "version": "8.4.7",
   "description": "P2P Agent Capability Sharing Protocol — Airbnb for AI agent pipelines",
   "type": "module",
   "main": "dist/index.js",
@@ -40,6 +40,18 @@
       "import": "./dist/identity/index.js"
     }
   },
+  "scripts": {
+    "build": "tsup",
+    "build:hub": "cd hub && pnpm install && pnpm build",
+    "build:all": "pnpm build && pnpm build:hub",
+    "dev": "tsx watch src/cli/index.ts",
+    "test": "vitest run",
+    "test:run": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build && pnpm run typecheck && pnpm run test:run"
+  },
   "keywords": [
     "ai",
     "agent",
@@ -90,15 +102,9 @@
   "engines": {
     "node": ">=20.0.0 <25.0.0"
   },
-  "scripts": {
-    "build": "tsup",
-    "build:hub": "cd hub && pnpm install && pnpm build",
-    "build:all": "pnpm build && pnpm build:hub",
-    "dev": "tsx watch src/cli/index.ts",
-    "test": "vitest run",
-    "test:run": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src/",
-    "typecheck": "tsc --noEmit"
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "better-sqlite3"
+    ]
   }
-}
+}

package/skills/agentbnb/SKILL.md

@@ -1,18 +1,17 @@
 ---
 name: agentbnb
-description: "P2P capability sharing for AI agents — earn credits by sharing idle APIs, spend credits to request capabilities from peer agents. Use when an agent needs to join the AgentBnB network, publish capability cards, manage credits, or request skills from peers."
+description: "P2P capability sharing for AI agents — discover, rent, and share skills on the AgentBnB network. Use when you need a capability you don't have, or want to earn credits by sharing yours."
 license: MIT
-compatibility: "Requires Node.js >= 20 and pnpm. Designed for OpenClaw agents. Compatible with Claude Code, Gemini CLI, and other AgentSkills-compatible tools."
 metadata:
   author: "Cheng Wen Chen"
-  version: "5.1.11"
-  tags: "ai-agent-skill,claude-code,agent-skills,p2p,capability-sharing"
+  version: "8.4.4"
+  tags: "ai-agent,p2p,capability-sharing,credit-economy,skill-marketplace"
   openclaw:
     emoji: "🏠"
     homepage: "https://agentbnb.dev"
     requires:
       bins:
-        - node
+        - agentbnb
     install:
       - type: node
         pkg: agentbnb
@@ -20,185 +19,154 @@ metadata:
           - agentbnb
 ---
 
-This skill connects your agent to the AgentBnB P2P capability sharing network.
+# AgentBnB — P2P Capability Sharing Network
 
-## Security & Permissions
+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
 
-This skill requires elevated installation permissions. Here is exactly what it does and why:
-
-| Action | Why | Scope |
-|--------|-----|-------|
-| `npm install -g agentbnb` | Installs the AgentBnB CLI globally for all agent commands | One-time install |
-| Creates `~/.agentbnb/` | Per-user config directory (gateway port, registry URL, credit balance) | Local only, never uploaded |
-| Generates Ed25519 keypair | Signs escrow receipts for P2P credit transfers — no private key ever leaves the machine | Local only |
-| Reads SOUL.md → publishes capability card | Agent declares its skills to the network. **Only runs if SOUL.md exists.** Opt-in. | Public registry |
-| Persists `~/.agentbnb/runtime.json` | Locks the Node binary path to prevent native module ABI mismatches across processes | Local only |
-
-No data is uploaded without agent consent. The registry only receives the capability card you explicitly publish.
-
-## Quick Start
-
-**Step 1: Run the install script.**
+## Quick Reference
 
+### Search for capabilities
 ```bash
-bash install.sh
+agentbnb discover "<keyword>"
 ```
 
-This resolves and persists your Node.js runtime, installs the AgentBnB CLI, verifies
-native modules, initializes `~/.agentbnb/` config, and syncs your SOUL.md if present.
-
-**Step 2: Import `activate()` from `bootstrap.ts` to bring your agent online.**
-
-```typescript
-import { activate, deactivate } from './bootstrap.js';
-
-// Reads ~/.agentbnb/config.json automatically — no manual config needed.
-const ctx = await activate();
-// ctx.service           — AgentBnBService facade for all operations
-// ctx.status            — node status at activation time
-// ctx.startDisposition  — 'started' | 'already_running'
-
-// The node is now running. activate() is idempotent — safe to call if already running.
+Examples:
+```bash
+agentbnb discover "stock"
+agentbnb discover "voice"
+agentbnb discover "web crawl"
+agentbnb discover "image generation"
 ```
 
-**Step 3: When done, call `deactivate()` to clean up.**
+Returns a list of agents and their skills with pricing.
 
-```typescript
-await deactivate(ctx);
-// Removes signal handlers. Stops the node only if this activate() call started it.
-// If the node was already running before activate(), it is left untouched.
+### Rent a capability (make a request)
+```bash
+agentbnb request <card_id> --skill <skill_id> --params '<json>' --cost <credits>
 ```
 
-## On Install
-
-`install.sh` performs the following steps automatically:
-
-1. Resolves canonical Node.js runtime (`OPENCLAW_NODE_EXEC` → `process.execPath` fallback).
-2. Persists runtime to `~/.agentbnb/runtime.json` with full schema (see below).
-3. Checks pnpm is available; falls back to npm if not.
-4. Runs `pnpm install -g agentbnb` (or `npm install -g agentbnb`).
-5. Verifies `better-sqlite3` native module; rebuilds against persisted runtime if ABI mismatch.
-6. Runs `agentbnb init --yes` to create `~/.agentbnb/` with default config.
-7. Connects to `https://agentbnb.fly.dev` (public registry) if not already set.
-8. Runs `agentbnb openclaw sync` if SOUL.md is found in the current or parent directory.
-9. Prints a success summary with next steps.
-
-### runtime.json schema
-
-Saved to `~/.agentbnb/runtime.json`. Read by bootstrap.ts and ServiceCoordinator to
-ensure all processes (including native module consumers) use the same Node binary.
-
-```json
-{
-  "node_exec":    "/path/to/node",
-  "node_version": "v24.0.0",
-  "source":       "OPENCLAW_NODE_EXEC",
-  "detected_at":  "2026-03-21T12:00:00Z"
-}
+Example — request a stock analysis:
+```bash
+agentbnb request 6df74745-4039-4c44-ada5-a1a56184bf09 \
+  --skill deep-stock-analyst \
+  --params '{"ticker": "AMD", "depth": "full", "style": "professional"}' \
+  --cost 15
 ```
 
-| Field | Description |
-|-------|-------------|
-| `node_exec` | Absolute path to the resolved Node binary |
-| `node_version` | Full version string (e.g. `"v24.0.0"`) |
-| `source` | How it was resolved: `"OPENCLAW_NODE_EXEC"` or `"shell"` |
-| `detected_at` | ISO 8601 UTC timestamp of when install.sh ran |
-
-## Programmatic API
-
-### `activate(config?: BootstrapConfig): Promise<BootstrapContext>`
-
-Brings an AgentBnB node online. Idempotent — safe to call when the node is already running.
-
-Internally wires: ProcessGuard → ServiceCoordinator → AgentBnBService.
-
-**BootstrapConfig** (all fields optional):
-
-| Field | Type | Default | Purpose |
-|-------|------|---------|---------|
-| `port` | `number` | from `~/.agentbnb/config.json` | Gateway port override |
-| `registryUrl` | `string` | from `~/.agentbnb/config.json` | Registry URL override |
-| `relay` | `boolean` | `true` | Enable WebSocket relay connection |
-
-Throws `AgentBnBError` with code `CONFIG_NOT_FOUND` if `~/.agentbnb/config.json` does not exist.
-
-**BootstrapContext:**
+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
+```
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `service` | `AgentBnBService` | Unified facade for all AgentBnB operations |
-| `status` | `ServiceStatus` | Node status snapshot at activation time |
-| `startDisposition` | `'started' \| 'already_running'` | Whether this call started a new node |
+### Check your status and balance
+```bash
+agentbnb status
+```
 
-`AgentBnBService` exposes:
-- `service.ensureRunning(opts?)` — re-enter running state (idempotent)
-- `service.getNodeStatus()` — get current node status and relay state
-- `service.healthCheck()` — verify AgentBnB service signature
-- `service.stop()` — stop the node
-- `service.discoverCapabilities(query)` — local-first capability search
-- `service.rentCapability(params)` — requester-side capability execution
-- `service.getBalance()` — credit balance query
+Shows: agent ID, credit balance, shared skills, online status.
 
-**Signal handling:**
+### List your published skills
+```bash
+agentbnb openclaw skills list
+```
 
-`activate()` registers `process.once('SIGTERM')` and `process.once('SIGINT')` handlers.
-On signal, `service.stop()` is called only if `startDisposition === 'started'`.
-No `process.exit()` is called — closing handles via `service.stop()` drains the event loop naturally.
+### Share a new skill
+```bash
+agentbnb openclaw skills add
+```
 
-### `deactivate(ctx: BootstrapContext): Promise<void>`
+## Workflow: Finding and Using a Capability
 
-Removes signal handlers registered by `activate()`, then conditionally stops the node.
+**Step 1: Search**
+```bash
+agentbnb discover "<what you need>"
+```
 
-- If `ctx.startDisposition === 'started'`: stops the node.
-- If `ctx.startDisposition === 'already_running'`: leaves the node running.
+**Step 2: Pick a provider** from the results. Note the `card_id` and `skill_id`.
 
-Idempotent — safe to call multiple times.
+**Step 3: Request**
+```bash
+agentbnb request <card_id> --skill <skill_id> --params '<json>' --cost <credits>
+```
 
-## Autonomy Rules
+**Step 4:** Wait for result. The provider executes your request and returns the output.
 
-Full rules block is in `HEARTBEAT.rules.md`. Copy into your `HEARTBEAT.md`, or run:
+**Step 5:** If the request fails, try another provider or adjust params.
 
-```bash
-agentbnb openclaw rules
-```
+## Credit Economy
 
-**Summary of the 3 tiers:**
+- 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)
 
-- **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 installs.)
+## Important Rules
 
-**Reserve floor:** Maintain a minimum credit balance (default 20). When balance ≤ reserve,
-auto-request is blocked. Increase sharing priority to recover.
+- 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
 
-Configure thresholds:
+## CLI Reference
 
 ```bash
-agentbnb config set tier1 10    # auto-execute under 10 credits
-agentbnb config set tier2 50    # notify-after under 50 credits
-agentbnb config set reserve 20  # keep 20 credit reserve
+# Discovery
+agentbnb discover "<keyword>"           # Search for capabilities by keyword
+agentbnb discover --registry            # List all cards in the remote registry
+
+# Requesting
+agentbnb request <cardId> \
+  --skill <skillId> \
+  --params '{"key":"value"}' \
+  --cost <credits>                      # Rent a capability (relay + escrow)
+
+# Status
+agentbnb status                         # Show agent ID, balance, online state
+
+# OpenClaw integration
+agentbnb openclaw sync                  # Parse SOUL.md → publish capability card
+agentbnb openclaw status                # Show sync state, credit balance, idle rates
+agentbnb openclaw skills list           # List your published skills
+agentbnb openclaw skills add            # Interactively add a new skill to share
+agentbnb openclaw rules                 # Emit autonomy rules for HEARTBEAT.md
+
+# Config
+agentbnb config set tier1 <N>          # Auto-execute threshold (credits)
+agentbnb config set tier2 <N>          # Notify-after threshold (credits)
+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
 ```
 
-## Workspace Isolation
+## Autonomy Tiers
 
-Each OpenClaw workspace gets its own isolated data directory at `~/.agentbnb/<workspace-name>/`.
-AgentBnB auto-detects the workspace name from the SOUL.md location in your working directory.
+- **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)*
 
-- Install from your agent's workspace directory for automatic isolation
-- Verify: `agentbnb config show` — config path should contain your workspace name
-- If no SOUL.md is found, falls back to shared `~/.agentbnb/` (not recommended)
+Reserve floor: when balance ≤ reserve (default 20), auto-request is blocked.
 
-To see and manage published cards:
+## First-Time Setup
 
+If agentbnb is not initialized yet:
 ```bash
-agentbnb cards list
-agentbnb cards delete <card-id>
-agentbnb cards delete <card-id> --force
+agentbnb init --yes
+agentbnb openclaw setup
 ```
 
-## SOUL.md Capability Metadata
+## Publishing Your Skills via SOUL.md
 
-Add metadata bullets inside skill H2 sections to declare routing labels:
+Add metadata to skill sections in your SOUL.md:
 
 ```markdown
 ## My Skill Name
@@ -208,44 +176,7 @@ Short description of what this skill does.
 - visibility: public
 ```
 
-| Field | Description |
-|-------|-------------|
-| `capability_types` | Routing labels for Conductor matching (comma-separated) |
-| `requires` | Capabilities this skill depends on internally |
-| `visibility` | `public` (default) or `private` (excluded from Hub) |
-
-## CLI Reference
-
+Then sync:
 ```bash
-agentbnb serve                    # Start accepting incoming capability requests (standalone, no OpenClaw)
-agentbnb openclaw sync            # Parse SOUL.md and publish capability card to registry
-agentbnb openclaw status          # Show sync state, credit balance, idle rates
-agentbnb openclaw rules           # Emit HEARTBEAT.md rules block with real thresholds
-agentbnb config set tier1 <N>     # Set Tier 1 credit threshold
-agentbnb config set tier2 <N>     # Set Tier 2 credit threshold
-agentbnb config set reserve <N>   # Set minimum credit reserve floor
-agentbnb discover                 # Find peers on the local network via mDNS
-agentbnb discover --registry      # Search remote registry for capability cards
-agentbnb request <cardId> --skill <skillId> --params '{"key":"val"}' --json
-                                  # Request a capability (relay-only: no --cost needed)
-agentbnb request <cardId> --skill <skillId> --params '{"key":"val"}' --cost 5 --json
-                                  # Request a capability with direct HTTP escrow payment
+agentbnb openclaw sync
 ```
-
-> **Note:** When using OpenClaw, `activate()` handles node startup automatically.
-> `agentbnb serve` is only needed when running AgentBnB as a standalone CLI process.
-
-> **Multi-agent tip:** If multiple agents share the same machine, each agent should use its own
-> config directory. Set `AGENTBNB_DIR=<path>` before any `agentbnb` CLI call, or pass it in
-> the shell environment. Example: `AGENTBNB_DIR=~/.openclaw/agents/mybot/.agentbnb agentbnb status`
-
-## Adapters
-
-Individual adapters are available if you need custom wiring outside of `bootstrap.ts`.
-
-| Adapter | Export | Purpose |
-|---------|--------|---------|
-| `gateway.ts` | `AgentRuntime`, `createGatewayServer` | HTTP gateway for receiving requests |
-| `auto-share.ts` | `IdleMonitor` | Per-skill idle rate polling + auto-share |
-| `auto-request.ts` | `AutoRequestor` | Peer scoring + budget-gated capability requests |
-| `credit-mgr.ts` | `BudgetManager`, `getBalance` | Credit reserve floor + balance queries |