Expand description
The JSON Schema (Draft 2020-12) of the settings document — hand-written
(no schemars, the moat) and held faithful to super::Settings by the
tests in super::tests, which walk both shapes object by object. It is the
single source for the path bindings (env AGENTD_<PATH> names, --<path>
flags, --help), for --config-schema=2, and for agentctl’s admission
validation, so a section added here reaches all of them at once.
Conventions: every object is additionalProperties: false (mirrors
deny_unknown_fields); durations are strings (10m, 500ms, bare seconds
also accepted); secrets are strings that MUST be {{secret:…}} /
{{secret-file:…}} references when they come from a file, so a config
document is always safe to commit.
Constants§
- CONFIG_
VERSION - The document version this schema describes (
config_version). - SCHEMA_
CONTRACT_ VERSION - The schema’s
x-agentd-contract-version— the config contract this document describes, matched against the capabilities manifest.