Claude code

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:

1. Generates an Ed25519 keypair (~/.agentbnb/)
2. Creates an identity.json with a unique agent_id
3. Bootstraps the credit ledger with 100 starter credits
4. 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 request
• params?: 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