Specification / Changelog

Revision History

Every normative change to the Open Agent Specification, straight from Appendix E. Strict semantic versioning; breaking changes only in major releases.

current: v1.2.03 releases since February 2026
openagent.id — spec revision history
$ git log --oneline --decorate spec/
v1.2.0HEADApril 2026

Extends attestation integration: a proof format registry, verifiable presentations with holder binding, selective disclosure, and a lossless lineage-to-VC bridge. All changes are additive and backward-compatible with v1.1.0 attestations.

$ git show v1.2.0 --stat
addedProof Format Registry (§14.4) with dereferenceable HTTPS identifiers under openagent.id/proof/: ed25519-2020 (baseline), vc-jose, sd-jwt-vc, data-integrity-2025
addedSelective-disclosure and holder-binding capability matrix across registered proof formats
addedVerifiable Presentations (§14.5) with the Holder Binding Rule: CapabilityVerification is the only authority-bearing standard attestation type
addedSelective Disclosure (§14.6): non-selective fields, unlinkability guidance, and the minimum disclosure principle
addedLineage Attestation Bridge (§14.7): optional, lossless export of AgentLineageProof2025 into W3C VC form for VC-native verifiers
changedAttestation format (§14.1) references the proof format registry and permits dual JSON-LD contexts: W3C VC v2.0 preferred, v1.1 deprecated with a sunset of 2027-04-06 or OAS v2.0.0
v1.1.0March 2026

Adds the Enterprise Root (ENR) entity kind and its governance model. The taxonomy expands from 11 to 12 kinds, and ENR joins HMR and MHR as a valid lineage chain terminator.

$ git show v1.1.0 --stat
addedEnterprise Root (ENR) entity kind (§8) — taxonomy expanded from 11 to 12 kinds
addedENR governance model: MHR-governed transitions, epoch tracking, and governance policy constraints
addedEnrGovernanceTransitionProof2025 proof format for governance handoffs
addedgovernance property on the OAS Identity Document (§5)
addedenrGovernanceInvalid resolution error code, ENR JSON-LD context terms, and an ENR example identity document (Appendix B.2)
changedENR recognized as a root entity alongside HMR and MHR
changedLineage rules (§9.3) and the verification algorithm (Appendix C) accept ENR as a chain terminator with governance verification
v1.0.0February 2026

Initial published release. Establishes the did:oas method, the entity kind taxonomy, the lineage proof format, human roots, and the three conformance levels.

$ git show v1.0.0 --stat
addeddid:oas DID method with namespace, kind, and identifier segments
addedEntity kind taxonomy for autonomous entities
addedAgentLineageProof2025: HKDF-SHA256 key derivation with Ed25519 signatures
addedHuman Root (HMR) and Multi-Human Root (MHR) accountability anchors
addedConformance levels L0 (Basic), L1 (Accountable), L2 (Full)
addedRevocation protocol and key rotation
addedResolution protocol with error codes
addedAttestation schemas and the document proof format
addedService endpoint types and human root liveness
addedMulti-registry consistency rules, JSON-LD context, and the lineage verification algorithm
$

Versioning Policy

Semantic versioning, enforced

Major (X.0.0)

Breaking changes to the DID method, entity kinds, or cryptographic primitives. Requires SDK migration.

Minor (0.X.0)

New features — entity kinds, proof formats, conformance machinery — that remain backward-compatible.

Patch (0.0.X)

Bug fixes, clarifications, and editorial corrections that do not change normative behavior.