Schema Reference - ADL v1

This is the canonical reference for every field defined in schema/v1/schema.json. The schema is JSON Schema Draft-07 and validates manifests with apiVersion: adl.inference-gateway.com/v1.

Manifest shape

apiVersion: adl.inference-gateway.com/v1 # required
kind: Agent # required
metadata: # required
  name: string
  description: string
  version: x.y.z
  # optional: author, license, tags
spec: # required
  capabilities: { ... } # required
  server: { ... } # required
  language: { ... } # required
  # optional: card, agent, config, services, acronyms,
  #           tools, skills, artifacts, hooks, scm,
  #           development, deployment

Top-level

Field	Required	Reference
apiVersion	✓	apiVersion / kind
kind	✓	apiVersion / kind
metadata	✓	metadata
spec	✓	spec

spec.*

Field	Required	Reference
capabilities	✓	capabilities
card		card
agent		agent
config		config
services		services
acronyms		acronyms
tools		tools
skills		skills
server	✓	server
language	✓	language
artifacts		artifacts
hooks		hooks
scm		scm
development		development
deployment		deployment

Appendix

• Secrets & interpolation - the ${VAR} placeholder convention, which fields carry it, and where the LLM provider credential comes from (a runtime env var, not the manifest).
• License identifiers - the accepted SPDX set for metadata.license and spec.skills[].license.