Skip to main content

Documentation Index

Fetch the complete documentation index at: https://agentvolumes.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Agent Volumes publishes machine-readable companion artifacts under schemas/ for clients, bibliothecas, validators, exporters, and conformance runners. This page is a publication-layer inventory. The prose specification remains the final normative authority, and schemas/README.md remains the source artifact for this inventory.

Primary schema families

AreaSchema artifacts
Manifest modelvolume.schema.json
Release metadatarelease-metadata.schema.json, exact-release-metadata-case.schema.json
Version indexversion-index.schema.json, version-index-row.schema.json
Release uploadrelease-upload-intent.schema.json, release-upload-finalize.schema.json
Trust discoverytrust-summary.schema.json, trust-detail.schema.json
Trust uploadtrust-upload-intent.schema.json, trust-upload-finalize.schema.json
Trust verification fixturestrust-artifact-verification-case.schema.json
Advisoriesadvisory.schema.json, advisory-list.schema.json, advisory-validation-case.schema.json
Capability metadatacapability-metadata.schema.json, bridge-metadata.schema.json, reserved-extension-namespaces.json
Errors and warningsproblem-details.schema.json, problem-registry.schema.json, warning.schema.json
Conformanceconformance-report.schema.json, conformance-coverage.schema.json
Manifest and semantic casesmanifest-parse-case.schema.json, semantic-validation-case.schema.json, component-dependency-validation-case.schema.json
External dependenciesexternal-dependency-validation-case.schema.json, upstream-baseline.schema.json, purl-vers-compatibility-exceptions.schema.json, external-dependency-potential-exposure-warning-context.schema.json
BOM/provenance mappingmapping-matrix.schema.json, mapping-sample.schema.json, external-dependency-declarations-predicate.schema.json
Searchsearch-results.schema.json

How to read this inventory

  • Schema $id values include the Agent Volumes spec release, for example https://agentvolumes.org/spec/0.1.0-rc.1/schemas/<artifact>.
  • Schema artifacts are version-aligned with agent-volumes-spec.md.
  • A material schema change is a normative draft change and is reviewed with the prose and conformance fixtures it affects.
  • reserved-extension-namespaces.json is a versioned companion artifact, but it is not itself a JSON Schema document.

Validation expectations

After changing any schema or schema-backed fixture, run the repository artifact validator:
npm run validate:artifacts
After changing schemas referenced by the Bibliotheca API contract, also run the OpenAPI linter:
npm run lint:openapi
The public site summarizes the schema families for readers. Use the repository artifacts for validation and release review: schemas/README.md, the individual schemas/*.json files, and the fixture mappings under conformance/fixtures/.

Conformance fixtures

See how fixture files map to schema validation units and deterministic evaluators.

Requirement inventory

Connect schema and fixture coverage to role-scoped AV-BIB-* and AV-CLI-* requirements.