Optional retail profile

Used-vehicle disclosure

dealeragent.used-vehicle.read/0.1 adds one read-only tool for the facts that make every used unit different.

Core remains small. New-only stores can implement Core without this profile. A gateway that claims structured used-vehicle disclosure implements the profile and its behavioral tests.

The tool

dealeragent.inventory.get_used_vehicle_details accepts organization, rooftop, and one vehicle selector: gateway ID, VIN, or stock number. It returns only an already-published used, certified, or demo unit.

Response sections

Section	Meaning
`odometer`	Unit-bearing reading, federal-style disclosure status, observation, source, and freshness.
`inventory_tenure`	Stocked and first-listed timestamps, age basis, complete days, and as-of time.
`history_reports`	Provider-neutral links and authorized summaries with per-report provenance.
`title`	Title status, brands, jurisdiction, source, and freshness.
`condition_report`	Named inspection authority/system, component results, and disclosed damage.
`certification`	Manufacturer CPO, dealer, third-party, none, or unknown—never collapsed.
`reconditioning`	Dealer-approved public work descriptions and completion state; no internal cost.
`discrepancies`	Material source conflicts the agent must preserve.

Search additions

Inventory search accepts unit-bearing odometer ranges, inventory-age ranges, history-report status, certification type, and inventory_age_days sorting. A matched result carries the compact summary that justified the match.

Provider integration

CARFAX, AutoCheck, or another provider connects behind the gateway under the dealer's provider agreement. The protocol stores no provider credentials. A report response declares its access method and whether summary sharing is authorized. If it is not authorized, the schema rejects the summary.

{
  "provider_id": "com.carfax",
  "status": "available",
  "access": "public_link",
  "summary_sharing_authorized": false
}

Provider identifiers and examples do not imply endorsement or partnership.

ExampleOpen the complete response→