Real-time Agent Status
Benchmarked against: Anthropic — Streaming Messages Tools:
agent_heartbeat,factory_floor_status,update_captain_locationArchitecture: Cloud UB agent registry
SuperPortia provides real-time visibility into who's doing what. Every agent registers online via heartbeat, and the factory floor gives an at-a-glance operational overview.
Agent heartbeat
agent_heartbeat(current_task="Writing docs site pages")
| Field | Value |
|---|---|
agent_id | Auto from SP_AGENT_ID |
ship | Auto from SP_SHIP_ID |
platform | mac / win / web |
current_task | What the agent is doing |
last_seen | Updated to current time |
Heartbeat is called at session start (mandatory) and optionally during task switches.
Factory floor status
The "who's doing what" dashboard:
factory_floor_status()
Returns:
| Section | Content |
|---|---|
| Captain location | Where 夏哥 is working (台南工作室 / 家中) |
| Team status | Each agent: online/idle/working + current WO |
| Active WOs | All in_progress work orders |
| Awaiting review | WOs in review status (needs Captain) |
| Blocked items | WOs in blocked status |
| Recent completions | Recently approved WOs |
Example output
Captain: 台南工作室
Team Status:
Mac CLI 小克 — online (SS1) — WO-2026-0305-A7F
Mac App 小A — idle (SS1)
Win CLI 小克 — offline (SS2)
Active WOs:
WO-2026-0305-A7F — [SP-Docs] Fill sidebar batch 6 — in_progress
Awaiting Review:
WO-2026-0304-6E8 — [EGS-DevWorkflow] Strengthen Ch.3.4
WO-2026-0302-489 — [Infrastructure] Dispatch Worker migration
Blocked: none
Captain location
The Captain's working location is displayed on the factory floor:
update_captain_location(location="台南工作室", updated_by="小克")
| Location | Meaning |
|---|---|
台南工作室 | Office in Tainan — full work capacity |
家中 | Home — available but may be doing other things |
| Custom string | Any location description |
Agent online/offline lifecycle
| Status | How determined |
|---|---|
| Online | Recent heartbeat, no current task |
| Working | Recent heartbeat + current_task set |
| Offline | No recent heartbeat |
| Stale | last_seen > threshold (planned: configurable) |
Use cases
| Question | Tool | What you see |
|---|---|---|
| "Who's online?" | factory_floor_status() | All agents with status |
| "What's being worked on?" | factory_floor_status() | Active WOs section |
| "What needs my review?" | factory_floor_status() | Awaiting review section |
| "Is SS2 up?" | factory_floor_status() | Check Win agents online status |
| "Where is Captain?" | factory_floor_status() | Captain location field |
Related pages
| Page | Relationship |
|---|---|
| First Heartbeat | Heartbeat details |
| Fleet Management | Fleet operations |
| SRE Status | Infrastructure health |
| WO Admin | Work order tracking |