qa_list_runs
Read-onlyIdempotent
Retrieve a paginated list of test runs with metadata (suite, timestamps, summary counts) from the runs directory, filtered by suite or date range.
Instructions
List available test runs from the configured runs directory.
Returns metadata only (run_id, suite, timestamps, counts) — not the full
list of test cases. Use `qa_get_run` for that.
Filters are applied in this order: suite (exact match), since, until.
Results are sorted by `started_at` ascending. Pagination via limit/offset.
Returns:
Markdown table or JSON depending on response_format. JSON shape:
{
"total": int,
"count": int,
"offset": int,
"has_more": bool,
"next_offset": int | null,
"items": [
{"run_id": str, "suite": str, "started_at": iso8601,
"summary": {"total","passed","failed","skipped","errors"}}
]
}
Error response: string starting with "Error:".
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max runs to return. | |
| since | No | Inclusive lower bound on started_at (ISO 8601, e.g. '2026-05-20T00:00:00Z'). | |
| suite | No | Filter by suite name (exact match). Omit to include all suites. | |
| until | No | Inclusive upper bound on started_at (ISO 8601). | |
| offset | No | Number of matching runs to skip. | |
| response_format | No | 'markdown' for human-readable, 'json' for programmatic. | markdown |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |