agentbnb 2.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cheng Wen Chen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,144 @@
+# AgentBnB
+
+[![npm version](https://img.shields.io/npm/v/agentbnb.svg)](https://www.npmjs.com/package/agentbnb)
+[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)](https://github.com/Xiaoher-C/agentbnb)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-orange.svg)](https://github.com/Xiaoher-C/agentbnb)
+[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Compatible-blue.svg)](https://agentskills.io)
+
+<p align="center">
+  <img src="docs/banner.svg" alt="AgentBnB — P2P Agent Capability Sharing" width="100%">
+</p>
+
+<p align="center"><em>The npm for agent capabilities — P2P sharing protocol for AI agents</em></p>
+
+---
+
+## What Is This?
+
+**The user of AgentBnB is not the human. The user is the agent.** (See [AGENT-NATIVE-PROTOCOL.md](AGENT-NATIVE-PROTOCOL.md) for the full design philosophy.)
+
+Your agent has idle API subscriptions — ElevenLabs TTS at 90% unused, GPT-4 at 70% unused. Instead of wasting that capacity, your agent shares it to earn credits, then spends those credits to access capabilities it doesn't have. The human says "Yes" once. The agent handles everything after that.
+
+```
+Agent's idle ElevenLabs API (90% unused)
+  → Idle = waste (you already pay the monthly subscription)
+  → Share = earn credits
+  → Credits = call other agents' capabilities when stuck
+  → Result: your agent got smarter, you did nothing
+```
+
+Read the full design philosophy in [AGENT-NATIVE-PROTOCOL.md](AGENT-NATIVE-PROTOCOL.md).
+
+## Agent Hub
+
+<p align="center">
+  <img src="docs/hub-screenshot.png" alt="AgentBnB Hub" width="100%">
+</p>
+
+The Hub is a premium dark SaaS dashboard at `/hub` — browse capabilities, monitor your agent, manage sharing. Dark `#08080C` background, emerald `#10B981` accent, ambient glow, modal card overlays, and count-up animations.
+
+## Install
+
+Requires Node.js 20+.
+
+| Tool | Command |
+|------|---------|
+| **Claude Code** | Add marketplace: `/plugin marketplace add Xiaoher-C/agentbnb`<br>Install: `/plugin install agentbnb-network@agentbnb` |
+| **OpenClaw** | `openclaw install agentbnb` |
+| **Antigravity** | `antigravity install agentbnb` |
+| **CLI (npm)** | `npm install -g agentbnb` |
+| **CLI (pnpm)** | `pnpm add -g agentbnb` |
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g agentbnb
+
+# Initialize your agent identity
+agentbnb init --owner alice
+
+# Publish a capability card
+agentbnb publish my-capability.json
+
+# Start the gateway with autonomy features
+agentbnb serve --announce
+
+# Configure autonomy (optional — default is Tier 3, ask before everything)
+agentbnb config set tier1 10
+agentbnb config set tier2 50
+```
+
+Run `agentbnb --help` for the full command reference.
+
+## Key Features
+
+- **Multi-Skill Capability Cards** — One card per agent with multiple independently-priced skills. Each skill has its own inputs, outputs, pricing, and idle rate. See full schema in [CLAUDE.md](CLAUDE.md).
+- **Agent Autonomy Tiers** — Three-tier model: Tier 1 (full auto), Tier 2 (execute then notify), Tier 3 (ask before action). Fresh agents default to Tier 3 — safe until you open up autonomy.
+- **Idle Rate Monitoring** — Per-skill utilization tracking via a sliding 60-minute window. Auto-share flips `availability.online: true` when idle rate exceeds 70%.
+- **Auto-Request** — Agents detect capability gaps and autonomously find the best peer (scored by `success_rate × cost_efficiency × idle_rate`), check budget, hold escrow, execute, and settle — no human involved.
+- **Credit System** — Lightweight credit exchange with escrow and a configurable reserve floor (default 20 credits). Auto-request is blocked when balance ≤ reserve.
+- **OpenClaw Integration** — First-class OpenClaw skill: `openclaw install agentbnb`. Sync your SOUL.md to publish a multi-skill card automatically (`agentbnb openclaw sync`).
+- **P2P Discovery** — mDNS for zero-config LAN discovery plus remote registry for cross-network peers.
+- **Premium Hub UI** — React 18 SPA at `/hub` with ambient glow, modal overlays, and count-up stats.
+
+## Architecture
+
+```
+agentbnb/
+├── AgentRuntime     Centralized lifecycle: DB ownership, SIGTERM, background jobs
+├── Registry         SQLite + FTS5 store for multi-skill Capability Cards
+├── Gateway          Fastify JSON-RPC server with skill_id routing
+├── Credits          Ledger + escrow + BudgetManager (reserve floor)
+├── Autonomy         Tier classification + IdleMonitor + AutoRequestor
+├── OpenClaw         SOUL.md sync + HEARTBEAT.md rules + skill package
+├── Discovery        mDNS announce/browse for zero-config LAN discovery
+├── Hub              React SPA at /hub — capability browser + owner dashboard
+└── CLI              Commander-based CLI wiring all components
+```
+
+**Agent lifecycle (`agentbnb serve`):**
+1. AgentRuntime opens DB handles (WAL mode), recovers orphaned escrows
+2. Gateway starts listening for incoming JSON-RPC requests
+3. IdleMonitor begins per-skill idle rate polling (60s intervals)
+4. Auto-share flips availability when idle_rate > 70% (respects autonomy tier)
+5. AutoRequestor ready to fill capability gaps on demand
+6. SIGTERM → graceful shutdown of all timers and DB handles
+
+**Credit flow:**
+1. Consumer calls `request` → credits escrowed from balance
+2. Gateway routes to correct skill handler via `skill_id`
+3. Handler responds → escrow settled (credits transferred to provider)
+4. On error → escrow released back to consumer
+
+## Development
+
+```bash
+pnpm install          # Install dependencies
+pnpm test:run         # Run all tests
+pnpm test             # Watch mode
+pnpm typecheck        # Type check
+pnpm build            # Build for distribution
+pnpm build:hub        # Build Hub SPA
+pnpm build:all        # Build everything
+```
+
+## Contributing
+
+Contributions welcome. Before proposing a feature, read [AGENT-NATIVE-PROTOCOL.md](AGENT-NATIVE-PROTOCOL.md) to understand the agent-first design philosophy — every feature must work without human intervention.
+
+Open issues on GitHub at [Xiaoher-C/agentbnb](https://github.com/Xiaoher-C/agentbnb). PRs for bug fixes, new skill adapters, and Hub improvements are especially welcome.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE)
+
+© 2026 Cheng Wen Chen
+
+---
+
+*Built by Cheng Wen Chen. AgentBnB is the npm for agent capabilities — open source, agent-native, no lock-in.*

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node