Core Concepts

Agents

An agent is a long-running loop: observe → reason → act → journal. WU BOT hosts the loop; you write the intent.

The loop

  ┌──────────┐   ┌────────┐   ┌────────┐   ┌─────────┐
  │ observe  │─▶ │ reason │─▶ │  act   │─▶ │ journal │
  └──────────┘   └────────┘   └────────┘   └─────────┘
        ▲                                        │
        └────────────────────────────────────────┘

Stages

Observe — pulls bars, book snapshots, and portfolio state from cached data streams.
Reason — invokes the strategy graph plus (optionally) an LLM for context-heavy branches.
Act — proposes orders, checks risk caps, routes through the broker driver.
Journal — writes an immutable record of state, prompt, decision, and fill.

Swarms

Multiple agents can share a research context. Use a swarm preset when you want a committee-style review before an order is placed.

bash

wu-bot swarm run analyst-trio --ticker NVDA