Run API tests defined in .tarn.yaml files. Writes artifacts under .tarn/runs// 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.

Validate .tarn.yaml test files without executing them. Checks YAML syntax and schema validity.

List all available tests in .tarn.yaml files. Returns file names, test names, and step counts.

Analyze a Tarn JSON report and return a prioritized fix plan with next actions, evidence, and remediation hints. Accepts either a report object from tarn_run or the same inputs as tarn_run to execute first.

Return the grouped failures (NAZ-402) for a specific run as structured JSON. Reads the persisted failures.json rather than re-running the tests. Useful for agents that want a failures-only view without loading the full report.

Return artifact paths plus existence flags for a specific run. Does not load any artifact payload — just tells the agent what is on disk for the given run.

Rerun only the failing (file, test) pairs from a prior run. Response shape matches tarn_run (run_id, artifacts, report) so agents can loop run → inspect → rerun without switching tool surfaces.

Render the concise report (NAZ-404) for a persisted run: a tiny JSON envelope with totals, exit code, and grouped failures. No HTTP, no test execution — purely reads summary.json + failures.json.

Inspect a prior run's archived report (NAZ-405) at run, file, test, or step granularity. Optional filter_category narrows the view to one FailureCategory. Response includes artifact paths for the run that seeded the view.

Map a change (files / endpoints / openapi ops / git diff) to the .tarn.yaml tests it most likely affects, with confidence tiers and run hints. Read-only: no HTTP and no test execution. Equivalent to: tarn impact --format json.

Generate a minimal .tarn.yaml skeleton from one of four input modes (OpenAPI operation id, raw curl, method+url, or a recorded fixture). Returns the rendered YAML plus structured metadata (TODOs, inferred request, validation). Optional out writes the file to disk. Equivalent to: tarn scaffold --from-openapi / --from-curl / --method+--url / --from-recorded.

Run a suite with report_mode=agent pre-selected, surfacing the compact AgentReport (NAZ-412) plus artifact paths. Preferred entry point when the caller will iterate on failures. Equivalent to: tarn run --agent.

Return only the root-cause failure groups (NAZ-402) for a run, without the wider failures envelope. The fastest failures-first read for an agent planning a fix. Equivalent to: tarn failures --format json (groups only).

Assemble a remediation bundle (NAZ-414) from a prior run's artifacts: failing entries enriched with YAML snippets, request/response excerpts, captures lineage, and rerun hints. Supports truncation budgets for context-limited agents. Equivalent to: tarn pack-context.