Skip to main content

AgDR-AKI: Sub-microsecond AI accountability SDK. Court-admissible forensic records (PPP Triplet) with cryptographic proof for regulated AI (EU AI Act, Canada Evidence Act).

Project description

AgDR-Phoenix Version PyPI CI License: Apache 2.0 License: CC0 1.0 Runtime: Rust + PyO3 Stewarded by GGF

Atomic Kernel Inference SDK for Phoenix v1.8.9

Developed by the Genesis Glass Foundation (Fondation Genèse Cristal), a federally incorporated Canadian not-for-profit. founding@accountability.ai

"AgDR satisfies a CISO. AgDR satisfies a judge."

What It Does

AgDR-Phoenix seals every AI decision at the exact moment it occurs. Each record carries a PPP Triplet (Provenance, Place, Purpose), a coherence score, a reputation scalar, and a HumanDeltaChain linking machine output to human oversight or escalation.

The result is a tamper-evident, court-admissible decision record with a clear chain of custody from the instant of inference. Zero-knowledge proofs allow selective disclosure to regulators and courts without exposing the underlying reasoning.

Installation

Python (PyPI)

pip install agdr-aki

Rust (crates.io)

cargo add agdr-aki

Build from Source

pip install maturin[patchelf]
git clone https://github.com/aiccountability-source/AgDR-Phoenix
cd AgDR-Phoenix
maturin develop --release

Quick Start

from agdr_aki import AKIEngine, PPPTriplet, HumanDeltaChain

engine = AKIEngine("records.db")

ppp = PPPTriplet(
    provenance="Phoenix v1.8 ACME",
    place="Toronto CA PIPEDA",
    purpose="AgDR"
)

hdc = HumanDeltaChain(
    agent_decision_ref="aki_001",
    resolved=True,
    terminal_node="autonomous"
)

record = engine.capture(
    ctx={"claim": "CLM-12345"},
    prompt="Process claim #12345",
    reasoning_trace={"steps": ["analyze", "decide"]},
    output="Approve",
    ppp_triplet=ppp,
    human_delta_chain=hdc
)

print(record.id)
print("Coherence:", record.coherence_score)
print("Reputation:", record.reputation_scalar)

Zero-Knowledge Proofs

AgDR-Phoenix supports lightweight on-demand zero-knowledge proofs on sealed records.

zk_proof = record.generate_zk_proof(mode="full_validity")
court_pkg = record.to_court_package(include_zk_proof=True)
print(court_pkg)

Properties

  • Proves the record is contemporaneous, tamper-evident, PPP-compliant, and correctly signed
  • Reveals nothing about the original context, prompt, reasoning trace, or output
  • Verification uses only the public Merkle root
  • Designed for regulators and courts under PIPEDA and the Canada Evidence Act

Core Concepts

Concept Description
PPP Triplet Provenance, Place, Purpose immutable legal anchor recorded at inference time
Atomic Kernel Inference (AKI) Sub-microsecond sealed decision capture at the exact moment of inference
HumanDeltaChain Required fiduciary link tracking human oversight or escalation and enforced at API level
Coherence Score Normalized cosine similarity against the agent's historical spine (0.0 - 1.0)
Reputation Scalar Exponentially weighted moving average of past coherence, provides a longitudinal reliability signal
Sealed Record Tamper-evident post-encryption object with BLAKE3 hash and Ed25519 signature
Zero-Knowledge Proof Selective disclosure of record integrity without revealing decision content

Evidentiary Architecture

Layer Implementation
Hashing BLAKE3
Signing Ed25519 (downstream of AKI hot path)
Chaining Forward-secret Merkle tree
Persistence Write-Ahead Log (WAL)
Degradation Limitations Act 2002 (Ontario): 2-year basic, 15-year ultimate
Admissibility Canada Evidence Act, portable to EU AI Act (August 2026)
Privacy Zero-knowledge proof layer for selective disclosure

Distinction from Structural Monitoring

AgDR captures semantic decision provenance: what the agent decided, why, under what authority, and with what confidence, sealed at the moment of inference.

Structural container monitoring (e.g., the AGA standard) records whether the system was running correctly. AgDR records what the system actually decided. Both serve different functions in an AI governance stack.

Specification and Standards

Resource Reference
Reasoning Capture Methodology v1.0 ISBN 978-1-7389042-1-1
Library and Archives Canada Deposited under CC-BY 4.0
Steward Genesis Glass Foundation, federally incorporated, royalty-free anchor in articles of incorporation

License

Dual-licensed under Apache 2.0 OR CC0 1.0.

The AgDR open standard is stewarded by the Genesis Glass Foundation (Fondation Genèse Cristal), a federally incorporated Canadian not-for-profit. The royalty-free grant is anchored in the Foundation's articles of incorporation.

Contributing

See CONTRIBUTING.md. All contributions are welcome. The standard is open.

Contact

Genesis Glass Foundation

founding@accountability.ai

https://accountability.ai

Resources

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agdr_aki-1.8.11.tar.gz (31.6 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

agdr_aki-1.8.11-cp39-abi3-win_amd64.whl (256.6 kB view details)

Uploaded CPython 3.9+Windows x86-64

agdr_aki-1.8.11-cp39-abi3-manylinux_2_34_x86_64.whl (358.1 kB view details)

Uploaded CPython 3.9+manylinux: glibc 2.34+ x86-64

agdr_aki-1.8.11-cp39-abi3-macosx_11_0_arm64.whl (315.9 kB view details)

Uploaded CPython 3.9+macOS 11.0+ ARM64

File details

Details for the file agdr_aki-1.8.11.tar.gz.

File metadata

  • Download URL: agdr_aki-1.8.11.tar.gz
  • Upload date:
  • Size: 31.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agdr_aki-1.8.11.tar.gz
Algorithm Hash digest
SHA256 b86ceb8ddceacee1bf72649c532e06dfbec7074ae1a6f5284cba45841b8bfae6
MD5 f15f27db3d405d4460496aae6cbb6953
BLAKE2b-256 e746d089d74012d47902392fa02e25fc792e2ed67110cb553aac2711a860323e

See more details on using hashes here.

Provenance

The following attestation bundles were made for agdr_aki-1.8.11.tar.gz:

Publisher: publish.yml on aiccountability-source/AgDR-Phoenix

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agdr_aki-1.8.11-cp39-abi3-win_amd64.whl.

File metadata

  • Download URL: agdr_aki-1.8.11-cp39-abi3-win_amd64.whl
  • Upload date:
  • Size: 256.6 kB
  • Tags: CPython 3.9+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agdr_aki-1.8.11-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 195854870575342c44cf2ab1e111104b35701a49cab6f8b09667259b31b9f345
MD5 69839904b3ea269b63e1a59bb3109817
BLAKE2b-256 027ab4c65f2db55c0b703010ed05d9e14f673813a14771eb96497ce3f2da5518

See more details on using hashes here.

Provenance

The following attestation bundles were made for agdr_aki-1.8.11-cp39-abi3-win_amd64.whl:

Publisher: publish.yml on aiccountability-source/AgDR-Phoenix

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agdr_aki-1.8.11-cp39-abi3-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for agdr_aki-1.8.11-cp39-abi3-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 00f19b136ee1c3913f36bf7c8cde3628311e2aef789a622a0f11273c419e1f9d
MD5 ef16c3278500df12ae4eaf97e4df0f07
BLAKE2b-256 6953dc71a99ff617875dadb1da192c6f5b8bb52c335e1553ee38b842f82ecf89

See more details on using hashes here.

Provenance

The following attestation bundles were made for agdr_aki-1.8.11-cp39-abi3-manylinux_2_34_x86_64.whl:

Publisher: publish.yml on aiccountability-source/AgDR-Phoenix

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agdr_aki-1.8.11-cp39-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for agdr_aki-1.8.11-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 dc211a9630182e64335704355c90600e3f98a42e8246847486126dc532b2a078
MD5 76c49d1a6e59dd55073aae4c83bef762
BLAKE2b-256 5308dfcf1fe5647af207f2c032cc36c6a25c13fae4629469d32036f23e83f308

See more details on using hashes here.

Provenance

The following attestation bundles were made for agdr_aki-1.8.11-cp39-abi3-macosx_11_0_arm64.whl:

Publisher: publish.yml on aiccountability-source/AgDR-Phoenix

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page