Draft teaching specification · v0.1 · reviewed 2026-07-30

Agent-Safe Unique Inventory Spec

This profile keeps a physical item, its product model, and its current offer distinct. Validation checks internal consistency; it does not grant platform access, synchronize inventory, authorize checkout, or guarantee retrieval.

Download the full specification · JSON Schema · JSON-LD context · Test records · Conformance statement · Changelog

Relationship model

product/model 1 ── n physical item 1 ── n offer version
                         │                    │
                         └ condition evidence └ price, state, policy

The physical-item ID follows the exact owned object. The offer ID follows current commercial terms. Channel listing IDs may map to those records but cannot silently replace them.

Minimum record

Group	Required truth
Identity	Physical-item, product, and offer IDs; factual title; canonical URL.
Evidence	Exact-item images, normalized condition, notes, inspection date, and evidence URLs.
Offer	Minor-unit price, currency, quantity, availability, observation time, seller and policy URLs.
Lifecycle	Version, state, and update time that agree with the offer.

Lifecycle

available → reserved → sold
    ↑           │
    └─ released ┘
available → withdrawn

Sold and withdrawn are terminal for the current offer. A relist is a new version and must not erase evidence needed to detect a duplicate live offer.

Stable rule IDs

ASUI-SHAPE-REQUIRED: required groups exist.
ASUI-CONDITION-EVIDENCE: condition notes and evidence describe the exact unit.
ASUI-AVAILABILITY-QUANTITY: quantity agrees with availability.
ASUI-LIFECYCLE-AGREEMENT: lifecycle and offer states agree.
ASUI-LIFECYCLE-TIME: lifecycle time does not precede offer observation.

Validate a record

Paste JSON to run the same stable cross-field rules used by the checked-in build validator. This is not platform certification.

Agent-Safe record JSONNo record checked.

Implementation status

The profile is vendor neutral. Its Instica field mapping is proposed, not claimed as shipped, until the production inventory contract and a real export are verified. Text, schema, and examples are CC BY 4.0; no DOI has been assigned.