# Agent Volumes

## Docs

- [Changelog](https://docs.agentvolumes.org/changelog.md): Curated release notes and historical release snapshots for the Agent Volumes specification.
- [Agent Volumes core concepts and terminology](https://docs.agentvolumes.org/concepts.md): The essential vocabulary for working with Agent Volumes: volumes, bibliothecas, manifests, identity, component types, publishers, trust, and package roles.
- [Contribute to the Agent Volumes specification](https://docs.agentvolumes.org/contributors.md): Route specification feedback, pull requests, security reports, and community conduct concerns for the Agent Volumes specification project.
- [Implement Agent Volumes](https://docs.agentvolumes.org/implementers.md): A practical starting point for building experimental Agent Volumes clients, bibliothecas, validators, and exporters from the v0.1.0-rc.1 artifacts.
- [Introduction to Agent Volumes](https://docs.agentvolumes.org/index.md): Agent Volumes is the open standard for packaging, distributing, and verifying components for AI agent runtimes — skills, tools, hooks, MCP servers, and more.
- [Authentication required](https://docs.agentvolumes.org/problems/authentication-required.md): Stable Problem Details type URI page for authentication-required.
- [Authorization failed](https://docs.agentvolumes.org/problems/authorization-failed.md): Stable Problem Details type URI page for authorization-failed.
- [Digest mismatch](https://docs.agentvolumes.org/problems/digest-mismatch.md): Stable Problem Details type URI page for digest-mismatch.
- [Idempotency conflict](https://docs.agentvolumes.org/problems/idempotency-conflict.md): Stable Problem Details type URI page for idempotency-conflict.
- [Identity mismatch](https://docs.agentvolumes.org/problems/identity-mismatch.md): Stable Problem Details type URI page for identity-mismatch.
- [Inconsistent registry state](https://docs.agentvolumes.org/problems/inconsistent-registry-state.md): Stable Problem Details type URI page for inconsistent-registry-state.
- [Problem Details type URIs](https://docs.agentvolumes.org/problems/index.md): Stable semantic identifier landing pages for Agent Volumes Problem Details type URIs.
- [Invalid archive](https://docs.agentvolumes.org/problems/invalid-archive.md): Stable Problem Details type URI page for invalid-archive.
- [Invalid manifest](https://docs.agentvolumes.org/problems/invalid-manifest.md): Stable Problem Details type URI page for invalid-manifest.
- [Invalid upload state](https://docs.agentvolumes.org/problems/invalid-upload-state.md): Stable Problem Details type URI page for invalid-upload-state.
- [Missing uploaded bytes](https://docs.agentvolumes.org/problems/missing-uploaded-bytes.md): Stable Problem Details type URI page for missing-uploaded-bytes.
- [Resource not found](https://docs.agentvolumes.org/problems/not-found.md): Stable Problem Details type URI page for not-found.
- [Payload too large](https://docs.agentvolumes.org/problems/payload-too-large.md): Stable Problem Details type URI page for payload-too-large.
- [Permission escalation](https://docs.agentvolumes.org/problems/permission-escalation.md): Stable Problem Details type URI page for permission-escalation.
- [Rate limited](https://docs.agentvolumes.org/problems/rate-limited.md): Stable Problem Details type URI page for rate-limited.
- [Subject binding mismatch](https://docs.agentvolumes.org/problems/subject-binding-mismatch.md): Stable Problem Details type URI page for subject-binding-mismatch.
- [Unsupported media type](https://docs.agentvolumes.org/problems/unsupported-media-type.md): Stable Problem Details type URI page for unsupported-media-type.
- [Upload expired](https://docs.agentvolumes.org/problems/upload-expired.md): Stable Problem Details type URI page for upload-expired.
- [Validation failed](https://docs.agentvolumes.org/problems/validation-failed.md): Stable Problem Details type URI page for validation-failed.
- [Version conflict](https://docs.agentvolumes.org/problems/version-conflict.md): Stable Problem Details type URI page for version-conflict.
- [Get started with Agent Volumes](https://docs.agentvolumes.org/quickstart.md): Create a volume.toml manifest, declare components, add compatibility metadata, and publish your first volume to a bibliotheca with the shelf CLI.
- [Bibliotheca capability metadata](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/bibliotheca-capability-metadata.md): Returns registry-level capability metadata, including capability schema/spec versions, HTTP API major family, and supported upload profiles such as the v0.1 `http-put` baseline.
- [Create a release upload intent for a scoped volume](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/create-a-release-upload-intent-for-a-scoped-volume.md)
- [Create a release upload intent for an unscoped volume](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/create-a-release-upload-intent-for-an-unscoped-volume.md)
- [Create a trust attachment upload intent for a scoped release](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/create-a-trust-attachment-upload-intent-for-a-scoped-release.md)
- [Create a trust attachment upload intent for an unscoped release](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/create-a-trust-attachment-upload-intent-for-an-unscoped-release.md)
- [Fetch one advisory](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/fetch-one-advisory.md)
- [Fetch resolver-facing version index rows for a scoped volume](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/fetch-resolver-facing-version-index-rows-for-a-scoped-volume.md)
- [Fetch resolver-facing version index rows for an unscoped volume](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/fetch-resolver-facing-version-index-rows-for-an-unscoped-volume.md)
- [Fetch scoped volume release metadata](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/fetch-scoped-volume-release-metadata.md)
- [Fetch volume release metadata](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/fetch-volume-release-metadata.md)
- [Finalize a release upload for a scoped volume](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/finalize-a-release-upload-for-a-scoped-volume.md)
- [Finalize a release upload for an unscoped volume](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/finalize-a-release-upload-for-an-unscoped-volume.md)
- [Finalize a trust attachment upload for a scoped release](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/finalize-a-trust-attachment-upload-for-a-scoped-release.md)
- [Finalize a trust attachment upload for an unscoped release](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/finalize-a-trust-attachment-upload-for-an-unscoped-release.md)
- [Search advisories](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/search-advisories.md)
- [Search the bibliotheca catalog for matching volumes](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/search-the-bibliotheca-catalog-for-matching-volumes.md)
- [Trust detail for a release](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/trust-detail-for-a-release.md)
- [Trust detail for a scoped release](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/trust-detail-for-a-scoped-release.md)
- [Trust summary for a release](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/trust-summary-for-a-release.md)
- [Trust summary for a scoped release](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/trust-summary-for-a-scoped-release.md)
- [Unpublish a scoped volume version](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/unpublish-a-scoped-volume-version.md)
- [Unpublish an unscoped volume version](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/unpublish-an-unscoped-volume-version.md)
- [Security advisory discovery API](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api/advisories.md): GET /api/v1/advisories — list and retrieve security advisories for volumes by advisory ID or volume name. Includes severity, affected ranges, and relationships.
- [Authenticate with the Registry API](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api/authentication.md): How to obtain a bearer token and authenticate write operations like publish and trust uploads against an Agent Volumes bibliotheca.
- [Bibliotheca capability metadata](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api/capabilities.md): GET /api/v1/capabilities — discover registry-wide features including scope policy, delivery modes, supported APIs, and upload profiles.
- [Registry API error codes and responses](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api/errors.md): RFC 9457 Problem Details error format and the complete list of Agent Volumes API error type slugs with HTTP status codes and meanings.
- [Fetch volume release metadata](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api/fetch.md): GET /api/v1/volumes/{name}/{version} — retrieve release metadata including purl, integrity digest, lifecycle status, distribution metadata, and external dependency declarations.
- [Registry API overview and base URL](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api/overview.md): Overview of the Agent Volumes bibliotheca HTTP API, covering versioning, base URL, authentication, response formats, and rate limiting tiers.
- [Publish a volume to a bibliotheca](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api/publish.md): Two-phase upload lifecycle for publishing volume packages — create an upload intent, PUT the archive bytes, then finalize to make the release available.
- [Search the volume catalog](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api/search.md): GET /api/v1/search — query the volume catalog by text, component type, runtime, provider, keyword, and publisher. Returns paginated discovery results.
- [Trust metadata: summary and detail views](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api/trust-metadata.md): Discover trust attachments — BOMs, provenance attestations, and signatures — for a published volume release via summary and detail endpoints.
- [Upload trust attachments for a release](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api/trust-upload.md): Two-phase upload lifecycle for attaching BOMs, provenance attestations, and signatures to a published release — create an intent, PUT bytes, then finalize.
- [Package version index for dependency resolution](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api/version-index.md): GET /api/v1/index/volumes/{name} — machine-facing version index rows for resolver inputs and candidate selection before exact metadata fetch.
- [SLSA manual build type v0.1](https://docs.agentvolumes.org/spec/0.1.0-rc.1/build/manual/v0.1.md): Stable documentation page for the Agent Volumes manual build type URI used in mapping fixtures.
- [Agent component: autonomous AI agent packaging](https://docs.agentvolumes.org/spec/0.1.0-rc.1/components/agent.md): Package an autonomous AI agent with its system prompt and tool bindings using the Agent component type in an Agent Volumes volume.
- [Command component: user-invocable slash commands](https://docs.agentvolumes.org/spec/0.1.0-rc.1/components/command.md): Create user-invoked slash commands that users trigger directly in their agent runtime using a defined trigger pattern like /review or /summarize.
- [Hook component: lifecycle event handlers](https://docs.agentvolumes.org/spec/0.1.0-rc.1/components/hook.md): Intercept agent runtime lifecycle events with Hook components that run automatically at defined points — session start, tool use, compaction, and more.
- [LSP Server component: Language Server Protocol](https://docs.agentvolumes.org/spec/0.1.0-rc.1/components/lsp-server.md): Distribute Language Server Protocol servers as Agent Volumes components for code intelligence, diagnostics, and editor integration in compatible runtimes.
- [MCP Server component: Model Context Protocol](https://docs.agentvolumes.org/spec/0.1.0-rc.1/components/mcp-server.md): Package Model Context Protocol servers as distributable volumes so any MCP-compatible agent runtime can discover, install, and run them.
- [Agent Volumes component types overview](https://docs.agentvolumes.org/spec/0.1.0-rc.1/components/overview.md): Overview of all seven component types — Agent, Skill, Command, Tool, Hook, MCP Server, and LSP Server — with the export model and directory layout.
- [Skill component: reusable agent knowledge](https://docs.agentvolumes.org/spec/0.1.0-rc.1/components/skill.md): Package instructional knowledge and task patterns as a Skill component that agent runtimes load into context to augment their capabilities.
- [Tool component: function endpoints for agents](https://docs.agentvolumes.org/spec/0.1.0-rc.1/components/tool.md): Define function-call tools that agents invoke programmatically during task execution, with typed inputs and outputs described in JSON or YAML.
- [Conformance fixtures and test vectors](https://docs.agentvolumes.org/spec/0.1.0-rc.1/conformance/fixtures.md): How to use the Agent Volumes conformance fixture corpus to validate your client or bibliotheca implementation against the v0.1 normative test suite.
- [Conformance requirements and claim labels](https://docs.agentvolumes.org/spec/0.1.0-rc.1/conformance/overview.md): Understand conformance claim labels, minimum viable client requirements, and minimum viable bibliotheca requirements for Agent Volumes v0.1.
- [Requirement inventory and deferred topics](https://docs.agentvolumes.org/spec/0.1.0-rc.1/conformance/requirements.md): How to read Agent Volumes role-scoped conformance IDs, fixture coverage, prose-boundary behavior, and deferred v0.1 topics.
- [Schema artifact inventory](https://docs.agentvolumes.org/spec/0.1.0-rc.1/conformance/schema-artifacts.md): Inventory of Agent Volumes v0.1 JSON Schema companion artifacts, schema families, versioning rules, and validation expectations.
- [Design principles](https://docs.agentvolumes.org/spec/0.1.0-rc.1/design-principles.md): The seven design principles behind Agent Volumes v0.1: runtime neutrality, component-centric discovery, identity, integrity, interoperability, simplicity, and incremental adoption.
- [Design rationale and decision records](https://docs.agentvolumes.org/spec/0.1.0-rc.1/design-rationale.md): Topic index for Agent Volumes v0.1.0-rc.1 decision records, deferred topics, and release design rationale.
- [Agent Volumes v0.1.0-rc.1 release archive](https://docs.agentvolumes.org/spec/0.1.0-rc.1/index.md): Frozen publication archive for the Agent Volumes v0.1.0-rc.1 release-candidate documentation surface.
- [Security advisories for volume packages](https://docs.agentvolumes.org/spec/0.1.0-rc.1/security/advisories.md): How security advisories work in Agent Volumes: structure, severity levels, affected version ranges, event-based version history, and the discovery API.
- [Content integrity and SHA-256 digest verification](https://docs.agentvolumes.org/spec/0.1.0-rc.1/security/content-integrity.md): How Agent Volumes uses normalized file-tree SHA-256 digests to guarantee that release content has not been tampered with between publish and install.
- [Publisher identity and verification levels](https://docs.agentvolumes.org/spec/0.1.0-rc.1/security/publisher-identity.md): How publishers register with a bibliotheca and the three verification levels: unverified, verified, and trusted — and what each level means for trust.
- [Supply chain security in Agent Volumes](https://docs.agentvolumes.org/spec/0.1.0-rc.1/security/supply-chain.md): How Agent Volumes addresses supply chain risks through content integrity, provenance attestation, and publisher verification for AI agent packages.
- [Specification authority and source of truth](https://docs.agentvolumes.org/spec/0.1.0-rc.1/specification-authority.md): How to read the Agent Volumes v0.1.0-rc.1 release archive, decision records, prose specification, companion artifacts, and site pages without confusing their authority.
- [Namespace and URI publications](https://docs.agentvolumes.org/spec/0.1.0-rc.1/uri-publications.md): Stable public documentation routes for Agent Volumes-owned namespaces, URI identifiers, schema IDs, problem types, and release evidence.
- [BOM and profile identifiers](https://docs.agentvolumes.org/spec/0.1.0-rc.1/uri-publications/bom-profile-identifiers.md): Agent Volumes BOM/profile identifiers used by trust artifacts and mapping fixtures.
- [External dependency declaration keys](https://docs.agentvolumes.org/spec/0.1.0-rc.1/uri-publications/external-dependency-declaration-keys.md): Stable Agent Volumes declaration key syntax and canonical input for external dependency declarations.
- [in-toto external dependency predicate](https://docs.agentvolumes.org/spec/0.1.0-rc.1/uri-publications/in-toto-external-dependency-predicate.md): Optional in-toto predicate identifier for Agent Volumes external dependency declarations.
- [PURL and VERS compatibility exceptions](https://docs.agentvolumes.org/spec/0.1.0-rc.1/uri-publications/purl-vers-compatibility-exceptions.md): Machine-readable Agent Volumes exceptions that align specific PURL types with VERS schemes for validation and warning context.
- [Reserved extension namespaces](https://docs.agentvolumes.org/spec/0.1.0-rc.1/uri-publications/reserved-extension-namespaces.md): Reserved Agent Volumes extension namespace keys for capability metadata and bridge migration checks.
- [Schema ID publication pages](https://docs.agentvolumes.org/spec/0.1.0-rc.1/uri-publications/schema-ids.md): Versioned JSON Schema identifier URLs for Agent Volumes v0.1.0-rc.1 schema and companion artifacts.
- [SPDX external dependency JSON-LD context](https://docs.agentvolumes.org/spec/0.1.0-rc.1/uri-publications/spdx-external-dependency-context.md): Published JSON-LD context for compact Agent Volumes SPDX external dependency declaration terms.
- [SPDX external dependency namespace](https://docs.agentvolumes.org/spec/0.1.0-rc.1/uri-publications/spdx-external-dependency-namespace.md): Canonical URI-backed SPDX extension namespace terms for Agent Volumes external dependency declarations.
- [Upstream PURL and VERS baselines](https://docs.agentvolumes.org/spec/0.1.0-rc.1/uri-publications/upstream-baselines.md): Pinned upstream references used by Agent Volumes PURL and VERS compatibility fixtures.
- [Runtime and protocol compatibility declarations](https://docs.agentvolumes.org/spec/0.1.0-rc.1/volumes/compatibility.md): How to declare which runtimes, protocols, providers, and environments your volume supports using [[runtimes]], [[protocols]], providers, and [environment].
- [Declaring dependencies in volume.toml](https://docs.agentvolumes.org/spec/0.1.0-rc.1/volumes/dependencies.md): How to declare volume-level and component-level dependencies with portable SemVer range constraints, plus single-version enforcement rules.
- [Volume and component identity with pkg:volume](https://docs.agentvolumes.org/spec/0.1.0-rc.1/volumes/identity.md): How volumes and components are identified using purl-compatible pkg:volume/... identifiers, including scoped names, versions, and component subpaths.
- [volume.toml manifest reference](https://docs.agentvolumes.org/spec/0.1.0-rc.1/volumes/manifest.md): Complete reference for every field in volume.toml — the required human-authoring format at the root of every Agent Volumes package.
- [Package roles: component, plugin, provider, meta](https://docs.agentvolumes.org/spec/0.1.0-rc.1/volumes/roles.md): Understand the four volume roles — component, plugin, provider, and meta — and how to choose the right one based on what your package exports.
- [Agent Volumes release archives](https://docs.agentvolumes.org/spec/index.md): Choose immutable Agent Volumes documentation archives by release version.

## OpenAPI Specs

- [bibliotheca.openapi](https://docs.agentvolumes.org/spec/0.1.0-rc.1/api-reference/bibliotheca.openapi.json)