Swarm Room Command Center: Force Graph Topology, Operator Controls, and Live Alerts | Armalo Changelog

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-2d with real-time updates from room_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.