| name | fleet-runs |
| description | Summarize Workflow-tool fleet runs from the Agent Monitor — these fleets emit no hooks and are ingested from on-disk run journals. List recent runs with status and agents-per-run, then drill into a single run's per-agent detail. Reconciles against the live run-state endpoints. Use when reviewing Workflow() fleets rather than hook-instrumented interactive sessions.
|
Fleet Runs
Summarize Workflow-tool (Workflow()) fleet runs and drill into one run's agents.
Input
The user provides: $ARGUMENTS
- Empty → list the most recent fleet runs.
- A run ID → drill into that single run.
latest → drill into the most recent run.
These fleets emit no hooks; the dashboard ingests them from on-disk Workflow-tool run journals, so this data is independent of the hook event stream.
Data Sources
| Endpoint | Returns |
|---|
GET /api/workflows/runs | List of ingested fleet run journals: run id, status, agent count, timing |
GET /api/workflows/runs/{runId} | One run in detail: per-agent status, timing, type, and outputs |
GET /api/run | Live run state across the fleet (current/active runs) |
GET /api/run/{id} | Live state for one run, to reconcile against the journal |
Report Sections
1. Runs Overview (when listing)
| Run ID | Status | Agents | Started | Duration |
|---|
Sort most recent first. Add a one-line status mix below (e.g. 8 runs: 5 completed, 2 running, 1 error). | | | | |
2. Run Detail (when a run ID / latest is given)
From GET /api/workflows/runs/{runId}, reconciled with GET /api/run/{id}:
- Header: run id, status, total agents, wall-clock duration.
- Per-agent table:
| Agent | Type | Status | Duration | Notes |
|---|
- Call out the longest-running agent and any agent with an error/failed status.
3. Status & Health
Completion rate (completed / total agents), any stalled or errored agents, and whether the journal and the live run-state endpoint agree (flag drift if they do not).
Output
- Markdown tables; status mix as a single summary line.
- Durations in human units (e.g.
3m 04s).
- Make explicit that these runs come from run journals (no hooks), so hook-derived metrics do not apply.
- Cite only runs and agents returned by the API; never invent runs.
- If there are no fleet runs, say so plainly.
- If the dashboard is unreachable, tell the user to start it with
npm start from the repo root.
