run_launch
Start or resume a single version's run over diagnosis or selection tasks, then poll status and read results. Detached by default to measure one arm before comparing candidates.
Instructions
Start or resume one arm: a run of one version over the tasks of the diagnosis or selection split, scored by the scenario. Use it to measure a single version; use run_interleaved to run a parent and candidates side by side. Detached by default: it returns at once while a background worker runs, so poll run_status, then read run_results. Writes run records, results and traces, and costs whatever the scenario's tasks cost (for example model calls). Resuming a run_id with the same parameters only fills missing task slots; changed parameters are refused. Returns the run status object.
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>",
"version": "<version>"
},
"name": "run_launch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Block until every task finishes instead of returning at once. Default false. | |
| smoke | No | Run only the first two tasks of the split as a quick check. Smoke arms cannot be gated or used for noise. Default false. | |
| split | No | Task split: `diagnosis` to explore and read failures, `selection` for gate evidence. Default `selection`. Confirmation and final splits are never available. | selection |
| 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. | |
| run_id | No | Arm name. Omit for a new random id; pass an existing id with identical parameters to resume that arm. Run ids are 1 to 80 letters, digits, `_` or `-`, starting with a letter or digit. | |
| repeats | No | Times each task runs, at least 1. Default 1. | |
| version | Yes | Version to run: 64-character lowercase SHA-256 version id, as returned by version_create. | |
| workers | No | Parallel task workers, 1 to 256. Default 1. |