Architecture

Architecture

ARGUS is a layered personal agent: everything above the autonomy line works offline. The economy is a clip-on gated on a wallet key.

Full reference: argus/docs/architecture.md

---

Five layers

#	Layer	Responsibility
1	Provider abstraction	One interface over Anthropic, OpenAI-compatible (DeepSeek, Qwen, GLM, Kimi…), and local Ollama. Tiered routing + cache_control.
2	Bounded agent core	Plan → execute → observe loop with hard token + USD budget and compaction.
3	Memory / self-learning	Episodes, distilled lessons, WARDEN tool-def pins in ~/.argus.
4	🛡️ MCP host + WARDEN	Bridge MCP tools only after static-scan → threat-feed → LUMEN reputation → pinning.
5	🛒 Opt-in economy	Discover · pay · invoke · settle (consumer); register · list · earn (provider). Wraps @aimarket/agent.

flowchart TB
  subgraph OFFLINE["Works offline"]
    L4["Layer 4 · WARDEN + MCP"]
    L3["Layer 3 · Memory"]
    L2["Layer 2 · Agent core + budget"]
    L1["Layer 1 · Providers"]
    L4 --> L3 --> L2 --> L1
  end
  LINE{{"autonomy line — needs wallet"}}
  L5["Layer 5 · Economy"]
  L2 -.-> LINE -.-> L5

Loading

---

Demand-side node

flowchart LR
  FACTORY["Factory"] --> HUB["Hub"]
  ORACLES["Oracles / LUMEN"] --> HUB
  ARGUS["ARGUS"] <--> HUB
  ARGUS --> MONITOR["Monitor"]

Loading

ARGUS consumes hub capabilities and can register its own. See Ecosystem-Role.

---

Module map (repo)

Area	Path
Agent loop	src/core/agent.ts
Budget governor	src/core/budget.ts
WARDEN gates	src/warden/
Economy	src/economy/
Channels	src/channels/
Config	src/config.ts, argus.config.example.json

---

Related

• WARDEN · Autonomy · Token-Budget · Channels · Economy