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 owned namespaces and URI identifiers under agentvolumes.org so implementers can cite, dereference, and validate the identifiers used by the specification and its companion artifacts. The repository remains authoritative. The public site is a publication layer for the canonical specification, schemas, OpenAPI contract, conformance fixtures, and decision records. Semantic identifier routes such as https://agentvolumes.org/build/manual/v0.1, https://agentvolumes.org/predicates/external-dependency-declarations/v0.1, https://agentvolumes.org/ns/spdx/external-dependency-declarations/v0.1#, and https://agentvolumes.org/problems/<slug> resolve to stable landing pages for the identifier itself. The SPDX JSON-LD context also has a stable canonical remote context URL at https://agentvolumes.org/contexts/spdx-external-dependency-declarations-v0.1.jsonld. Those stable routes link back to this release archive and to canonical repository artifacts. JSON Schema $id URLs remain release-scoped under https://agentvolumes.org/spec/<version>/schemas/<artifact>.

Publication matrix

Checklist itemPublic URL or identifierSource artifactImmutability / check evidence
SPDX extension namespacehttps://agentvolumes.org/ns/spdx/external-dependency-declarations/v0.1#agent-volumes-spec.md; conformance/fixtures/mapping-matrix.json; conformance/fixtures/mapping-sample.json; ADR-0141; ADR-0158Stable v0.1 namespace landing page plus archived release documentation. Record route status, content type, and release evidence.
SPDX extension JSON-LD contexthttps://agentvolumes.org/contexts/spdx-external-dependency-declarations-v0.1.jsonldsite/contexts/spdx-external-dependency-declarations-v0.1.jsonld; site/spec/0.1.0-rc.1/contexts/spdx-external-dependency-declarations-v0.1.jsonld; conformance/fixtures/mapping-sample.json; ADR-0141Stable canonical remote context URL plus release archive copy. Record dereference, content-type, and drift-check evidence.
in-toto predicate URIhttps://agentvolumes.org/predicates/external-dependency-declarations/v0.1agent-volumes-spec.md; conformance/fixtures/mapping-matrix.json; conformance/fixtures/mapping-sample.json; ADR-0142; ADR-0158Stable v0.1 predicate landing page plus archived schema and examples. Record route status, content type, and schema evidence.
Problem Details type URIshttps://agentvolumes.org/problems/<slug>schemas/problem-details.schema.json; schemas/problem-registry.schema.json; conformance/fixtures/problem-details-cases.json; openapi/bibliotheca.openapi.yaml; ADR-0152; ADR-0158Stable problem type landing pages plus archived closed v0.1 problem set. Check each slug route and record evidence before tagging.
JSON Schema $id URLshttps://agentvolumes.org/spec/0.1.0-rc.1/schemas/<artifact>schemas/*.json; schemas/README.md; conformance/README.mdRelease-versioned schema IDs are immutable after release. Record dereference and content-type checks for current release artifacts.
SLSA build type URIhttps://agentvolumes.org/build/manual/v0.1conformance/fixtures/mapping-sample.json; conformance/fixtures/mapping-matrix.json; ADR-0158Stable v0.1 build type landing page plus archived examples. Record route and example evidence in the release evidence issue.
Agent Volumes BOM/profile identifiersagent-volumes-bom-v0.1 and related profile identifiersagent-volumes-spec.md; conformance/fixtures/mapping-matrix.json; conformance/fixtures/mapping-sample.json; trust fixture familiesLocal string identifiers unless explicitly URI-backed. Record profile semantics and fixture evidence before tagging.
External dependency declaration key syntaxav-extdep-v1:sha256:<lowercase-hex-sha256>agent-volumes-spec.md; schemas/external-dependency-validation-case.schema.json; conformance/fixtures/external-dependency-validation-cases.json; ADR-0143Grammar is versioned by the av-extdep-v1 prefix. Record valid and invalid fixture evidence before tagging.
Capability extension reserved namespacesagent-volumes, core, specschemas/reserved-extension-namespaces.json; schemas/capability-metadata.schema.json; capability fixturesReserved-name set is version-aligned with schema release. Record schema ID and validator evidence before tagging.
Bridge and warning companion artifactsbridge-metadata.schema.json; warning.schema.json; external-dependency-potential-exposure-warning-context.schema.jsonschemas/bridge-metadata.schema.json; schemas/warning.schema.json; schemas/external-dependency-potential-exposure-warning-context.schema.json; bridge fixtures; external-dependency warning fixturesVersioned schema IDs are immutable after release. Record dereference and validator evidence with the schema publication checks.

Identifier pages

Stable semantic identifier pages:

Schema ID URLs

Versioned JSON Schema $id publication pages for the v0.1.0-rc.1 artifact set.

SPDX namespace

URI-backed SPDX extension terms for external dependency declarations.

SPDX JSON-LD context

Published JSON-LD context for compact SPDX external dependency declaration terms.

in-toto predicate

Optional predicate identifier for declaration-plane external dependency metadata.

Problem Details types

Stable pages for every closed v0.1 Problem Details type URI.

Reserved namespaces

Reserved capability extension namespace keys for the release line.

PURL/VERS exceptions

Machine-readable compatibility exceptions for validation and warning context.

Upstream baselines

Pinned upstream PURL and VERS references used by conformance fixtures.

SLSA manual build type

SLSA buildType identifier for manually assembled Agent Volumes mapping fixtures.

BOM/profile identifiers

Release-context strings used by trust metadata and BOM/provenance mapping fixtures.

Declaration keys

Versioned external dependency declaration key syntax and canonical digest input.

Release evidence workflow

For each release candidate or stable release:
  1. Install repository and site dependencies with bun install and (cd site && bun install).
  2. Refresh the Mintlify OpenAPI publication artifact with bun run build:site:openapi -- 0.1.0-rc.1.
  3. Validate the public site with bun run lint:site.
  4. Run the canonical gates: bun run lint:openapi and bun run validate:artifacts.
  5. Create a release evidence issue from .github/ISSUE_TEMPLATE/release-evidence.md.
  6. Fill the Namespace and URI publication evidence table with the public URL, source artifact, and route or immutability check evidence for each Issue #29 row.