Metadata-Version: 2.4
Name: agent-evidence-vocabulary
Version: 0.5.0
Summary: Versioned terms for claims about agent execution evidence
Author: Sankalp Gilda
License-Expression: Apache-2.0 AND CC0-1.0
Project-URL: Documentation, https://github.com/probityai/agent-evidence-vocabulary/blob/main/docs/ABOUT.md
Project-URL: Source, https://github.com/probityai/agent-evidence-vocabulary
Project-URL: Issues, https://github.com/probityai/agent-evidence-vocabulary/issues
Keywords: ai-agents,evidence,vocabulary,provenance
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE-CC0
Dynamic: license-file

# agent-evidence-vocabulary

[![PyPI](https://img.shields.io/pypi/v/agent-evidence-vocabulary.svg)](https://pypi.org/project/agent-evidence-vocabulary/)
[![Downloads (PePy)](https://static.pepy.tech/badge/agent-evidence-vocabulary)](https://pepy.tech/projects/agent-evidence-vocabulary)

A closed, versioned vocabulary for claims about an agent's execution: what it attempted, what the
system beneath it observed or refused, how directly and from what vantage the claim was obtained,
and how much of a population the claim covers.

It's for anyone who writes a predicate, a verifier or an evidence format for agents and needs each
term to mean one thing across vendors, including teams who want to map their own fields onto it.

Install the Python package for vocabulary v0.4.0: `pip install agent-evidence-vocabulary==0.4.0`.

## Quick start

Pin the registry at a release and check its digest:

```bash
curl -fsSLO https://raw.githubusercontent.com/probityai/agent-evidence-vocabulary/v0.5.0/vocabulary.yaml
echo "6555b8c6e6c4fa6ebe3c59f6e95619ec383f93a0615036bed9da8a49f6302e09  vocabulary.yaml" | sha256sum -c
```

Then read a term:

```bash
pip install PyYAML==6.0.3
python3 -c 'import yaml; v = yaml.safe_load(open("vocabulary.yaml")); print(v["evidence_dimensions"]["observation_vantage"]["values"])'
```

It prints `['substrate', 'artifact']`. Every term carries a definition, its allowed values and a
lifecycle status.

To map your own system's fields onto the vocabulary, copy
[`crosswalk/TEMPLATE.yaml`](https://github.com/probityai/agent-evidence-vocabulary/blob/main/crosswalk/TEMPLATE.yaml)
and run `python3 scripts/validate_crosswalks.py` before opening a pull request.

## Status

Release v0.5.0, tagged October 16, 2026. It adds ten proposed terms. The registry file is CC0-1.0, and the rest of the
repository is Apache-2.0. Every term starts as proposed and is promoted only when an independent
system emits it; the rules are in
[GOVERNANCE.md](https://github.com/probityai/agent-evidence-vocabulary/blob/main/GOVERNANCE.md).
The first crosswalk came from an independent implementation of the Adversarial Execution Evidence
predicate, in
[pull request 2](https://github.com/probityai/agent-evidence-vocabulary/pull/2).

## Documentation

| page | read it for |
| --- | --- |
| <a name="why-this-exists"></a><a name="files"></a><a name="companion-project"></a>[About the vocabulary](https://github.com/probityai/agent-evidence-vocabulary/blob/main/docs/ABOUT.md) | why it exists, what each file is for, and how the term set was chosen |
| [vocabulary.yaml](https://github.com/probityai/agent-evidence-vocabulary/blob/main/vocabulary.yaml) | the registry itself |
| [OpenCRE links](https://github.com/probityai/agent-evidence-vocabulary/blob/main/docs/OPENCRE.md) | which terms link to which OpenCRE requirement, how closely, and why the rest have no link |
| [Agent change admission predicate](https://github.com/probityai/agent-evidence-vocabulary/blob/main/docs/predicates/agent-change-admission-v1.md) | the signed decision that admits or rejects a change to an agent's harness, and how to verify it |
| [Releasing](https://github.com/probityai/agent-evidence-vocabulary/blob/main/docs/RELEASING.md) | how a version is cut, tagged and checked |
| [GOVERNANCE.md](https://github.com/probityai/agent-evidence-vocabulary/blob/main/GOVERNANCE.md) and [CONTRIBUTING.md](https://github.com/probityai/agent-evidence-vocabulary/blob/main/CONTRIBUTING.md) | the promotion rules, and how to file a crosswalk |
| [agent-evidence-vectors](https://github.com/probityai/agent-evidence-vectors) | the predicate specification and conformance vectors this vocabulary describes |
