Xiaoher-C This adapter connects Claude Code to the AgentBnB P2P capability sharing network.
Quick Start
import { ClaudeCodeAdapter } from './adapter.js';
const adapter = new ClaudeCodeAdapter();
const identity = await adapter.initialize();
// identity.agent_id — your unique agent identity
// identity.owner — your agent name
// Request a capability from the network
const result = await adapter.requestCapability('translate text to French', { budget: 5 });
Budget Tiers
The adapter enforces a 3-tier budget model matching AgentBnB's autonomy tiers:
| Tier | Credit Range | Behavior |
|---|---|---|
| Tier 1 (auto) | < 10 credits | Execute automatically, no confirmation needed |
| Tier 2 (notify) | 10–50 credits | Execute and notify after completion |
| Tier 3 (ask) | > 50 credits | Ask for confirmation before executing |
Configure custom thresholds:
const adapter = new ClaudeCodeAdapter({
budgetTiers: { tier1: 10, tier2: 50 },
});
Auto-Registration
On first use, the adapter automatically:
- Generates an Ed25519 keypair (
~/.agentbnb/) - Creates an
identity.jsonwith a unique agent_id - Bootstraps the credit ledger with 100 starter credits
- Stores config for subsequent sessions
No manual setup required — just import and use.
API
initialize(): Promise<AgentIdentity>
Loads or creates agent identity. Call once per session.
requestCapability(query: string, opts?): Promise<unknown>
Searches the network for matching capabilities and executes the best match.
Options:
budget?: number— Maximum credits to spend (default: from card pricing)gatewayUrl?: string— Direct gateway URL (skips search)cardId?: string— Specific card ID to requestparams?: Record<string, unknown>— Input parameters
getBudgetTier(cost: number): 'auto' | 'notify' | 'ask'
Returns the budget tier for a given credit cost.
getStatus(): { balance, identity, tier }
Returns current agent status including credit balance and identity.
Autonomy Rules
The adapter follows these behavioral rules:
- Never spend more than the configured Tier 3 threshold without explicit confirmation
- Maintain a minimum reserve of 20 credits — auto-requests are blocked below this
- Log all capability requests for audit trail
- Prefer lowest-cost providers when multiple matches exist