cotool/Cotool Validate Agents

Validate Cotool Response-Agents-as-Code YAML in CI against the Cotool validate API, with inline PR annotations.

Trust Signals

name	description	required	default
api_url	Base URL of the Cotool API.	no	https://app.cotool.ai
dir	Repo-relative directory to scan for agent YAML (and referenced prompt .md files). Matches the GitOps sync `path` default.	no	cotool/agents
file	Optional comma-separated list of specific files to validate. When set, overrides directory discovery.	no	""
recursive	Recurse into subdirectories of `dir` when discovering files.	no	true
audience	OIDC audience requested from GitHub and verified by the Cotool API.	no	cotool-validate
fail_on_warnings	Fail the check when any warnings are present (errors always fail).	no	false

name	description
valid	true when every validated YAML file has no errors.
error_count	Total number of error-severity diagnostics across all files.
warning_count	Total number of warning-severity diagnostics across all files.