Skip to main content
Trinity
Architecture/Operating Room

Operating Room

Unified operator command center with four tabs — Queue, Notifications, Cost Alerts, and System — providing real-time visibility into agent operations that require human attention.

Queue Tab

Shows items from agents' operator queues: questions, approval requests, and status updates.

Agents write to ~/.trinity/operator-queue.json inside their container.
A background sync service polls running agents every 5 seconds and persists items to the backend database.
Operators can respond to items directly; responses are written back to the originating agent.
Filter by status, type, priority, or agent name.
WebSocket events: operator_queue_new, operator_queue_responded, operator_queue_acknowledged.

Notifications Tab

Consolidated view of agent notifications (replaces the former standalone Events page).

Filter by status, priority, agent, or type.
Stats cards display counts by status.
Bulk selection and bulk actions.
Real-time updates via WebSocket.

Cost Alerts Tab

Cost threshold monitoring and alerting (replaces the former standalone Alerts page). Configure cost thresholds per agent or globally.

System Tab

System-level information and controls.

Sync Service

Restart-resilient sync between agent containers and the backend database.
Manual refresh button available.
Stale prompt detection flags items older than expected.

Operator Queue API

EndpointMethodDescription
/api/operator-queueGETList queue items
/api/operator-queue/statsGETQueue statistics
/api/operator-queue/{id}GETGet single item
/api/operator-queue/{id}/respondPOSTSubmit response
/api/operator-queue/{id}/cancelPOSTCancel item
/api/operator-queue/agents/{name}GETItems for a specific agent

MCP Tool

send_notification(agent_name, message, priority)— sends a notification to the Operating Room from within an agent.