Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

# TRACE Conformance Test Suite

### Verify your TRACE implementation before shipping
### Check a TRACE record and see which conformance level it reaches

<p align="center">
<a href="https://tests.agentrust-io.com">
Expand All @@ -25,7 +25,7 @@
[![CI](https://github.com/agentrust-io/trace-tests/actions/workflows/ci.yml/badge.svg)](https://github.com/agentrust-io/trace-tests/actions/workflows/ci.yml)
[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white&style=flat)](https://discord.gg/grgzFEHgkj)

> **Test suite v0.2.** Tracks [TRACE Spec v0.2](https://github.com/agentrust-io/trace-spec).
> Tracks [TRACE Spec v0.2](https://github.com/agentrust-io/trace-spec).

Check a TRACE record, inspect the findings, and produce a reproducible conformance report. The suite checks the record and supplied evidence; a passing report does not establish that an entire implementation meets every specification requirement.

Expand Down
8 changes: 4 additions & 4 deletions SPONSORS.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# Sponsors

TRACE Tests is an open-source AgenTrust project. Sponsors provide funding,
engineering time, infrastructure, or other in-kind support. Sponsorship does
not confer project ownership, governance authority, or control over technical
decisions or conformance results.
TRACE Tests is an open-source AgenTrust project. It is sponsored by OPAQUE
Systems, which funds the engineering, infrastructure and confidential-computing
work behind it. Organisations that want to support the project are welcome to
join as sponsors.

## Current sponsors

Expand Down
10 changes: 5 additions & 5 deletions docs/levels.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ TRACE defines three conformance levels. Higher levels require all lower-level mo
| Level | Required Modules | Use Case |
|-------|-----------------|----------|
| **0** | TR-ENV, TR-SIG, TR-POL, TR-APR | Software-only development and staging |
| **1** | Level 0 + TR-RTE, TR-SCA | Production TEE-attested records |
| **1** | Level 0 + TR-RTE, TR-SCA | Records that declare a TEE platform and measurement |
| **2** | Level 1 + TR-TXN, TR-ANC | Full records with transparency anchoring |

## Level 0 — Software-only
Expand All @@ -20,8 +20,8 @@ Level 0 records are signed with a software key. The `runtime.platform` must be `
"iat": 1750000000,
"subject": "spiffe://trust.example.org/agent/my-agent",
"model": {
"provider": "anthropic",
"model_id": "claude-sonnet-4-6",
"provider": "example-provider",
"model_id": "example-model-1",
"version": "20251001"
},
"runtime": {
Expand Down Expand Up @@ -82,8 +82,8 @@ Level 1 adds hardware attestation. `runtime.platform` must be a value from the `
"iat": 1750000000,
"subject": "spiffe://trust.example.org/agent/my-agent",
"model": {
"provider": "anthropic",
"model_id": "claude-sonnet-4-6",
"provider": "example-provider",
"model_id": "example-model-1",
"version": "20251001"
},
"runtime": {
Expand Down
4 changes: 2 additions & 2 deletions docs/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,8 +29,8 @@ record = {
"iat": int(time.time()),
"subject": "spiffe://trust.example.org/agent/sample",
"model": {
"provider": "anthropic",
"model_id": "claude-sonnet-4-6",
"provider": "example-provider",
"model_id": "example-model-1",
"version": "20251001",
},
"runtime": {
Expand Down
2 changes: 1 addition & 1 deletion docs/tutorials/writing-conformance-tests.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ TRACE defines three levels. Each level activates a cumulative set of modules:
| Level | Required modules | Typical use |
|-------|-----------------|-------------|
| 0 | TR-ENV, TR-SIG, TR-POL | Software-only development and staging |
| 1 | Level 0 + TR-RTE, TR-SCA | Production TEE-attested records |
| 1 | Level 0 + TR-RTE, TR-SCA | Records that declare a TEE platform and measurement |
| 2 | Level 1 + TR-TXN, TR-ANC | Full records with SCITT transparency anchoring |

At Level 0 you can set `runtime.platform` to `"software-only"` and skip hardware attestation entirely. At Level 1 you must supply a real TEE measurement from AMD SEV-SNP, Intel TDX, NVIDIA H100, or similar. Level 2 adds a SCITT receipt URI and a bound tool-call transcript hash.
Expand Down
3 changes: 2 additions & 1 deletion index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Verify your TRACE implementation
description: Run this suite against your implementation to find out which TRACE conformance level it actually reaches, and produce a report you can hand to an auditor, a counterparty, or an acquirer.
description: Run this suite against a TRACE record to see which conformance level it reaches, and produce a report anyone can reproduce from the record and the suite version.
---

# TRACE Test Suite
Expand Down Expand Up @@ -84,6 +84,7 @@ A conformance report that looks authoritative and cannot be checked is the same
| Signature | `TR-SIG` | ES256/ES384/EdDSA, key binding, chain |
| Runtime | `TR-RTE` | TEE platform, measurement format, RIM URI |
| Policy | `TR-POL` | Bundle hash, enforcement mode, TEE binding |
| Appraisal | `TR-APR` | Appraisal status, verifier URI, policy reference, timestamp |
| Transcript | `TR-TXN` | Tool-call transcript hash binding (Phase 2+) |
| Transparency | `TR-ANC` | SCITT receipt URI, inclusion proof |
| Provenance | `TR-SCA` | SLSA level, builder URI, digest format |
Expand Down
13 changes: 7 additions & 6 deletions mkdocs.yml
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
site_name: TRACE Tests
site_description: Conformance test suite for TRACETrust Runtime Attestation and Compliance Evidence
site_description: "Conformance test suite for TRACE: Trust Runtime Attestation and Compliance Evidence"
site_url: https://tests.agentrust-io.com
repo_url: https://github.com/agentrust-io/trace-tests
repo_name: agentrust-io/trace-tests
edit_uri: edit/main/
docs_dir: .
copyright: "© 2026 AgenTrust Apache 2.0"
copyright: "© 2026 AgenTrust contributors. Apache 2.0"

exclude_docs: |
.github/
Expand Down Expand Up @@ -66,10 +66,11 @@ plugins:
full_output: llms-full.txt
markdown_description: >-
TRACE Tests is the conformance suite for TRACE (Trust Runtime
Attestation and Compliance Evidence), the AgenTrust open standard for
signed, hardware-attested AI agent governance records. Use it to check
that your attestation receipts satisfy the specification, at each
conformance level, before shipping them to production.
Attestation and Compliance Evidence), an open specification for
portable, signed runtime evidence about AI agent runs. Use it to see
which conformance level a TRACE record reaches and to produce a report
anyone can reproduce. It checks the shape of attestation fields, not
the attestation itself.
sections:
Getting started:
- index.md
Expand Down
2 changes: 1 addition & 1 deletion overrides/main.html
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@
"@type": "SoftwareApplication",
"name": "TRACE Tests",
"applicationCategory": "DeveloperApplication",
"description": "Conformance tests and an integration harness for TRACE implementations. Verify that attestation receipts meet the specification before shipping to production.",
"description": "Conformance tests and an integration harness for TRACE records. It reports which conformance level a record reaches and checks the shape of attestation fields, not the attestation itself.",
"url": "{{ config.site_url }}",
"offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" },
"author": { "@type": "Organization", "name": "AgenTrust", "url": "https://agentrust-io.com" },
Expand Down