Compatibility and versioning

Capability schemas are versioned and served athttps://gateway.agenticdealernetwork.com/spec/v0/. Each capability in the tool reference links to its schema.

Changes we make without notice

• Adding a new tool.
• Adding a field to an object whose schema permits extension.
• Adding a capability-tier entry.

Whether a given object permits extension is declared in its schema. Check the schema rather than assuming — some v0 objects are closed.

Changes that get a new version

• Removing or renaming an output field, or changing its type.
• Changing what an existing field means.
• Adding an input parameter, or making an optional input required — tool inputs are closed objects.
• Removing a tool, or changing error codes or shapes.
• Adding a value to a closed enumeration — see below.

Breaking changes ship on a new version path served in parallel with the previous one for a stated window.

Normalized vocabularies

Vehicle data reaches ADN from many dealer feed vendors and dealer management systems. ADN normalizes that variance at ingestion, so the values you receive are stable and you may switch on them exhaustively. Vehicle condition is new or used; certification is a separate boolean.

Adding a value to one of these vocabularies would be a breaking change and would ship as a new contract version — not silently.

Object extension policy

Every object in the v0 surface is deliberately declared open or closed; the schema is the authority, this table is the summary.

• Open (new fields may appear; ignore unknown keys): the shared data shapes unit, unit_summary, androoftop_public, and both discovery manifests (network and rooftop).
• Closed (a new member is a version event): the error object, the freshness object, every tool input, and every public tool output wrapper. Closed inputs mean unknown arguments are rejected rather than ignored. One declared exception: the dealer-scopedealer.inventory.search output remains open in v0 — its schema is the authority.
• The error code list and the manifest authvocabulary are closed enumerations: a new value ships as a new contract version, never silently.