Repo Map

Canonical repositories, packages, and ownership surfaces for the ZBD Agents stack.

Use this page to orient engineering and product teams across the agent toolkit.

Canonical Repositories

agent-wallet

@zbdpay/agent-wallet package, zbdw binary, CLI workflows.

agent-fetch

@zbdpay/agent-fetch package, L402 client flow and token cache.

agent-pay

@zbdpay/agent-pay package, middleware adapters for Express, Hono, Next.js.

agent-wallet-dashboard

Local read-only dashboard for wallet files and operational checks.

The zbd.ai service underpins registration and Lightning Address resolution. The source repository may be private in some environments.

Package + Runtime Matrix

Surface	Type	Runtime	NPM
@zbdpay/agent-wallet	CLI	Node.js >= 22	Yes
@zbdpay/agent-fetch	Library	Node.js >= 22	Yes
@zbdpay/agent-pay	Library	Node.js >= 22	Yes
agent-wallet-dashboard	Next.js app	Node.js >= 22	No
zbd-ai	Next.js app/service	Node.js >= 22	No

Runnable Examples Coverage

Repository	examples/ directory	Fastest demo script
agent-fetch	Yes	examples/zbd-agent-fetch.mjs
agent-pay	Yes	examples/http-server.mjs
agent-wallet	No	Use zbdw fetch against agent-pay example
agent-wallet-dashboard	No	Use sample-data/ quick demo
zbd-ai	No	Use POST /api/register smoke test

Workspace Helpers

At the top-level agents workspace, these scripts are useful for full-suite verification:

npm run install:all
npm run build:all
npm run test:all
npm run verify:all

Where to Go Next

Quick Start

Start with a first-run path across setup, payment, and fetch.

Architecture

Understand request lifecycle and data boundaries.

Agent Wallet

Command reference and operational patterns.