failure_cards
List task failure cards for a run arm to diagnose failed tasks or fixes/breaks versus a parent run, and save them for later search.
Instructions
List failure cards for one arm: every task with outcome below 1, or, with parent_run and change, the tasks this arm fixed or broke against the parent. Use it to diagnose before proposing; use run_results for all rows, and failures_similar (HB workspaces) to search failures across runs. A card has task_id, group, outcome, reason, payload summary, output and trace pointer unless the scenario renders its own. Also saves the cards to the record store for later search, overwriting identical entries; nothing else changes. Returns an array.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"config": "<config>",
"run_id": "<run_id>"
},
"name": "failure_cards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| group | No | Return only cards of this exact task group. | |
| limit | No | Maximum items to return, at least 1. Omit to return all remaining items. | |
| change | No | `fix` for tasks that improved against parent_run, `break` for tasks that got worse. Omit to list all failures. | |
| config | Yes | Path of the scenario YAML file on the server host, absolute or relative to the server's working directory, for example `scenario.yaml`. It selects the workspace; a server started with --config rejects any other path. | |
| offset | No | Zero-based index of the first item to return. Default 0. | |
| run_id | Yes | Run id of the arm to read. | |
| details | No | Include payload summaries, outputs and trace pointers. False returns a compact index of task_id, group, outcome and reason; start with false on large runs. Default true. | |
| parent_run | No | Run id of the parent arm to pair with; required by change. | |
| aggregation | No | Repeat aggregation for the paired comparison: `mean` (default) or `majority`. | mean |