Browser (localhost:8000 → Live Demo)
├── QuickMart card (B2C, green)         SupplyHub card (B2B, amber)
│   Scrollable product grid              Scrollable procurement table
│   Click product → pre-fill agent       Click row → pre-fill + cross-sell
│   Trident FAB → agent panel (50%)      Trident FAB → agent panel (50%)
│
│         POST /buy          GET /events/{merchant} (SSE)
│
dashboard/app.py  (FastAPI + per-merchant wallet instances)
│
buyer_agent/agent.py  (Mistral Nemo 12B via NVIDIA NIM)
│   _handle_tool interceptor
│   ├── wallet.authorize(amount, category)  ← hard gate, not LLM-accessible
│   ├── wallet.debit(token)
│   └── MCP over stdio → mcp_server/server.py
│
mcp_server/server.py — 5 tools
│   ├── search_catalog
│   ├── get_product_details
│   ├── create_razorpay_order          ← REAL Razorpay Orders API
│   ├── process_payment                ← test-mode simulation
│   └── get_order_status
│
agent_wallet/wallet.py
└── authorize → one-time token → debit → SQLite audit log

rzp/
├── main.py                        # one command to run everything
├── requirements.txt
├── .env.example                   # RAZORPAY_KEY_ID · RAZORPAY_KEY_SECRET · NVIDIA_API_KEY
├── merchant.example.yaml
│
├── merchants/                     # wallet config per merchant
│   ├── quickmart.yaml             # B2C · ₹800/tx · grocery + pharma
│   └── supplyhub.yaml             # B2B · ₹5,000/tx · office + pantry + electronics
│
├── data/merchants/                # product catalogs (JSON → SQLite via ingestion)
│   ├── quickmart_catalog.json     # 8 products incl. Knorr Soup + Whey Protein
│   └── supplyhub_catalog.json     # 6 B2B SKUs with MOQ
│
├── ingestion/
│   └── normalizer.py              # LLM normalizer — any catalog format → SQLite
│
├── mcp_server/                    # MCP tools + Razorpay client
├── agent_wallet/                  # spend wallet with authorize/debit/token system
├── buyer_agent/                   # Mistral agent loop with Mistral quirk recovery
│
└── dashboard/
    ├── app.py                     # FastAPI · SSE · per-merchant wallet init · reset API
    └── static/
        └── index.html             # full-stack demo UI — single self-contained file

# 1. Install
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt

# 2. Keys
cp .env.example .env
# → fill RAZORPAY_KEY_ID, RAZORPAY_KEY_SECRET, NVIDIA_API_KEY

# 3. Run
python main.py
# → open http://localhost:8000 → click Live Demo

authorize(amount, category)
  ├── amount > per_tx_limit   → ❌ BLOCKED  (frontend shows OTP modal for QuickMart)
  ├── category not allowed    → ❌ BLOCKED  (agent explains gracefully)
  ├── balance < amount        → ❌ BLOCKED  (agent explains gracefully)
  └── all clear               → ✅ one-time token issued

debit(token)
  └── valid + unused token    → ✅ balance decremented + event written to audit log

curl -X POST http://localhost:8000/reset/quickmart
curl -X POST http://localhost:8000/reset/supplyhub