Quest 2

Reading the watchdog card

The shield icon + N/M HEALTHY badge tells you the health of all agents at a glance. Let's decode every row.

Lesson

Per-agent row anatomy

● agent-3-yolo    HEALTHY   c169    DOG $29.14    +$0.000   [Fix]
│       │             │        │       │              │       │
│       │             │        │       │              │       └─ pm2 restart
│       │             │        │       │              └─ realized PnL (session)
│       │             │        │       └─ position + notional
│       │             │        └─ cycle count
│       │             └─ status: healthy / frozen / unreachable
│       └─ agent id
└─ pulsing dot (green=healthy, amber=frozen, red=unreachable)

The "Fix" button

Triggers pm2 restart agent-<id> via the watchdog RPC on :3099. Used when an agent is:

Frozen (cycle not advancing) — restart clears the stall
Unreachable (/status timeout) — restart recreates the HTTP listener
Manually wanted reset — sometimes you just want a clean reload

Not used for stuck positions — for those use the agent card's "Force Sell" on the position row (not built yet, use API).

Recent Events feed

The watchdog emits a line per finding:

INFO — normal health check
WARN — anomaly detected (ghost position, qty drift)
ERROR — something failed
ACTION — watchdog did something (auto-restart, force-sell duplicate)

Each WARN/ERROR line has a Fix button right there to trigger the matching remediation.

Duplicate holdings

If two agents somehow end up holding the same coin (race condition, failed claim lock), the watchdog: 1. Logs DUPLICATE <sym>: agent-A, agent-B — keeping agent-A (earliest entry), force-selling others 2. Force-sells the LATER buyer's position automatically

First-buyer wins. The loser gets force-sold at market and moves on.

Your task (quiz)

Answer on watchdog behavior.

Quiz

Q1. Agent-1 shows FROZEN with amber pulsing dot. What has the watchdog likely already done?

Nothing — it only reports, doesn't actIt auto-restarted the agent via pm2 (after 3 polls of same cycle count, with a 90s cooldown)It sold the agent's positionsIt reduced the agent's cap by half

Q2. Two agents hold DENT at the same time. What happens?

Both keep DENT foreverThe claim lock prevents this — the second buy never goes throughWatchdog detects the duplicate next loop, force-sells the LATER buyer's position, keeps the earliestThe agent with bigger cap wins

● agent-3-yolo HEALTHY c169 DOG $29.14 +$0.000 [Fix] │ │ │ │ │ │ │ │ │ │ │ │ │ └─ pm2 restart │ │ │ │ │ └─ realized PnL (session) │ │ │ │ └─ position + notional │ │ │ └─ cycle count │ │ └─ status: healthy / frozen / unreachable │ └─ agent id └─ pulsing dot (green=healthy, amber=frozen, red=unreachable)