best
Fetch top-ranked programs from a run, ordered by measured performance, for checkpoints or closure.
Instructions
Read the best measured programs in a run.
Call this at checkpoints or after closure when you need the current leaders. The Engine
owns ranking and returns its program records in best-first order.
Returns: list[dict] containing up to k ranked program records, or the standard error dict.
Mistake to avoid: never call a candidate best without using this measured ranking.
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": {
"run_id": "<run_id>"
},
"name": "best"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| k | No | ||
| run_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |