Home / Docs / Una for agents / Schemas

una.diagnostics/1

Release v0.4.0

una.diagnostics/1 is a JSON document of the Agent ABI, defined in spec/13 §1. This page gathers what the specification says about it at v0.4.0: each section whole where it opens with the document, and otherwise the parts that name it.

Diagnostic model

From spec/13 §1, the parts that name this schema.

With --json, una check and una fmt --check print their diagnostics as one JSON object on stdout, followed by a newline (ADR 0012):

json
{ "schema": "una.diagnostics/1", "diagnostics": [], "fixable": 0 }

diagnostics holds the diagnostics in the order above, each with its own "schema": "una.diagnostic/1" field; a new version of the diagnostic shape also bumps the list version. The array is empty when there are no diagnostics, and exit codes do not depend on --json (§5). Whitespace is not significant; the reference implementation prints compact JSON with object keys in the order shown in this section.