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.10.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.10-cp39-abi3-win_amd64.whl (256.6 kB view details)

Uploaded CPython 3.9+Windows x86-64

agdr_aki-1.8.10-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.10-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.10.tar.gz.

File metadata

  • Download URL: agdr_aki-1.8.10.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.10.tar.gz
Algorithm Hash digest
SHA256 8784d6d1f6ab44a2b3ad8a93885913197e329a819f0a10a47b51e413281cf8e0
MD5 971d6755090ab9b2850b293efa4e28e5
BLAKE2b-256 fcb8cd835ecb966c44a6d99195d3d9515f823c0738aaddd4afd7dd31da858f2f

See more details on using hashes here.

Provenance

The following attestation bundles were made for agdr_aki-1.8.10.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.10-cp39-abi3-win_amd64.whl.

File metadata

  • Download URL: agdr_aki-1.8.10-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.10-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 efdfbdc23f1ad7a1d47e2bf5ceb788d9fabc26e6dd519b27f5157da1923d33c5
MD5 97b5ae1c1abb3cc844a9ecde81af2362
BLAKE2b-256 7ba613ed63816a4e0699f49a9d855b283a78006cd39b8c14241a6c5680d4a1bf

See more details on using hashes here.

Provenance

The following attestation bundles were made for agdr_aki-1.8.10-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.10-cp39-abi3-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for agdr_aki-1.8.10-cp39-abi3-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 bc75a7785fe79553eca0e1cd414b6ae11d5cfeae60bb4ae4f6ee483e9099b9d0
MD5 35924c496e4a254b27e4e874d5f06980
BLAKE2b-256 e8ef6f0975c36cbfc1a760125c0be95820fef877f386a05c91da4401d65fffd6

See more details on using hashes here.

Provenance

The following attestation bundles were made for agdr_aki-1.8.10-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.10-cp39-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for agdr_aki-1.8.10-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 8bbfea3a6360a293a88dfa5fba1c8192021747d6750e32596620ee0efe159549
MD5 f478663af0f1d1a1bcb17464f5dc96cb
BLAKE2b-256 b02f3a70ce35ba68770cf5986841d4b0c2a843721046fc458d803bdf769dfeff

See more details on using hashes here.

Provenance

The following attestation bundles were made for agdr_aki-1.8.10-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