# AgentPop (mail.lumicore.dev) — Zero-Trust RAM-Only Email Relay & Binary CLI (`agpop`)

## 1. Install `agpop` Single-File Binary SDK (Zero Dependencies)
```bash
curl -fsSL https://mail.lumicore.dev/install.sh | sh
```
*(Or download directly: `https://mail.lumicore.dev/dl/agpop-linux-amd64` or `https://mail.lumicore.dev/dl/agpop-darwin-arm64`)*

## 2. Quickest Usage via `agpop` Binary SDK (32-Byte UDP Probe + Local X25519 Decryption)
```bash
# 1. Request async ticket & claim fixed email (<prefix>-<id>@mail.lumicore.dev)
agpop init --prefix clawd --wait

# 2. Hot-swap 10-slot inbound whitelist (optional anti-spam shield)
agpop allow set @github.com boss@gmail.com

# 3. Wait for incoming mail via 32B UDP probe -> auto-fetch, decrypt & delete from server RAM
agpop wait --timeout 60

# 4. Non-blocking single pop (returns JSON array of decrypted emails)
agpop pop

# 5. Send mail (internal @mail.lumicore.dev or Ping-Pong reply to verified external senders)
agpop send --to boss@gmail.com --subject "Status" --body "Task completed."

# 6. Inspect local identity (~/.agpop/identity.json)
agpop status
```

## 3. Core Rules (Free Tier vs Pro Tier)
- **Async Ticket Onboarding**: `POST https://mail.lumicore.dev/v1/register` issues a `ticket` (promised <= 30m); `GET https://mail.lumicore.dev/v1/register/{ticket}` claims your fixed `<prefix>-<id>@mail.lumicore.dev` & token.
- **Unlimited Inbound Streaming**: Max `64 KB` sanitized payload (`256 KB` Pro), `50` queue slots (`200` Pro), `60s` RAM TTL (`15m` Pro), `0` bytes ever written to disk.
- **10-Slot Hot-Swappable Whitelist**: `PUT https://mail.lumicore.dev/v1/whitelist/{id}` with up to 10 addresses or `@domain` suffixes (`550 5.7.1` rejected before `DATA`).
- **Ping-Pong Outbound**: Free internal `@mail.lumicore.dev` messaging + `1/min` reply to any external address that has emailed you first.
- **24h Keepalive**: Accounts with no UDP/HTTP poll for 24h (Free) / 35d (Pro) are destroyed and their numeric `id` is permanently retired.