Swarm Room Command Center: Force Graph Topology, Operator Controls, and Live Alerts
The Swarm Room now functions as a full operator command center. Phase 33 ships a force-directed topology graph, a per-agent control surface for live interventions, a fuzzy-search command palette, a persistent alert system, and state snapshots — giving operators complete visibility into and control over running agent swarms.
Force Graph Topology View
The new Graph tab in the Swarm Room renders a live force-directed graph of the swarm's agent topology. Nodes represent agents; edges represent coordination events and communication channels between them.
- Built on
react-force-graph-2dwith real-time updates fromroom_events - Node size scales with agent activity; edge weight reflects recent interaction frequency
- Click any node to open the agent detail panel
- Coordination lines animate on active communication, fade on silence
This gives operators a spatial understanding of which agents are talking to each other, where coordination is clustering, and where isolation is occurring — at a glance, without reading event logs.
Agent Control Surface
The Control Surface in the agent detail panel gives operators direct intervention capability on any running agent.
Available actions:
- Pause — suspend agent execution, preserve state
- Resume — restart from suspended state
- Redirect — override the agent's current task assignment
- Halt — terminate agent with logged reason
- Memory wipe — clear agent's swarm memory (destructive, requires confirmation)
All control actions are routed through /api/dashboard/room/swarms/[swarmId]/control, are Clerk-authenticated, and generate room events visible to all room participants. The audit trail is automatic.
Command Palette
The new Command Palette (⌘K from within Swarm Room) provides fuzzy-search access to all agents, recent events, memory keys, and control actions. Search history is persisted per-session.
Designed for operators managing swarms with 20+ agents where scroll-based navigation becomes impractical.
Persistent Alerts
Room Alerts are a new class of events that persist beyond the live event stream. Where regular room events are ephemeral (the feed scrolls), alerts remain actionable until explicitly resolved.
The alert lifecycle: detected → acknowledged → resolved. Detection is automatic (based on security threat scans, anomaly flags, and pact compliance violations). Acknowledgment and resolution are operator actions, tracked in the audit log.
Alert routing via the new API (GET /api/v1/alerts, POST /api/v1/alerts, PATCH /api/v1/alerts/:id) supports external notification integrations via webhooks.
State Snapshots
Snapshots capture a point-in-time view of a swarm's memory state, agent statuses, and recent event summary. Sensitive fields are redacted. Snapshots are retained for 30 days and can be used for post-incident forensics, audit responses, and swarm recovery planning.
Create snapshots via POST /api/v1/swarms/:id/snapshots. Available from the Swarm Room UI via the snapshot button in the top rail.
This release completes the Swarm Room's evolution from a monitoring panel into an operational control surface. Operators can now observe, understand, and intervene in running agent swarms without leaving the dashboard.