Reference
Canonical source-of-truth for every public surface the v1.0 spec pins.
| Page | What it covers |
|---|---|
agent.yaml schema | Every field validated by the Zod schema, with examples and since versions. |
| CLI | Every declaragent <verb>, auto-extracted from the binary's help strings. |
| Environment variables | Every DECLARAGENT_* (plus provider keys + adapter-specific keys) read at runtime. |
| Provider matrix | Streaming, tools, images, audio support per provider. |
| Extension registry | Channel + source + plugin packages shipped by the monorepo. |
| Agent RPC | Envelope, topic conventions, RequestAgent, agent-inbox, ctx.respond. v1.1. |
| Fleet | fleet.yaml manifest, precedence rules, promote flow, deploy strategies, version skew. v1.2. |
Stability promise
From v1.0 onwards, every surface in this section follows SemVer:
- Patch (
v1.0.x) — bug fixes, doc tweaks, new validation rules that accept a strict superset of existing configs. - Minor (
v1.1.0) — new optional fields onagent.yaml, new CLI verbs, new adapter kinds. - Major (
v2.0.0) — any breaking change. Requires a migration and a lead time.
If you spot a surface that is under-documented, file an issue in github.com/declaragent/declaragent.