tarn_run
Run API tests from .tarn.yaml files and get a compact agent report with artifact paths.
Instructions
Run API tests defined in .tarn.yaml files. Writes artifacts under .tarn/runs/<run_id>/ and returns a compact agent report by default plus paths to the full artifacts so agents do not need to keep large JSON blobs in context.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Absolute path to the project root. tarn.config.yaml, tarn.env.yaml, and relative paths are resolved against this directory. Defaults to the workspace root captured during MCP `initialize`, or the server process's current directory. | |
| env | No | Environment name (loads tarn.env.{name}.yaml) | |
| path | No | Path to a .tarn.yaml test file or directory containing test files. Relative paths resolve against `cwd`. | |
| report_mode | No | Which slice of the run to return inline. `agent` (default) is the compact root-cause-first payload; `summary` and `failures` return the NAZ-401 artifacts; `full` returns the verbose JSON report. The run still writes every artifact regardless of the chosen mode. | |
| tag | No | Filter tests by tag (comma-separated) | |
| vars | No | Variable overrides as key-value pairs |