tarn_run
Run API tests from .tarn.yaml files with environment and tag filtering. Returns compact agent report and artifact paths to keep AI context lean.
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
TableJSON 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 |