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.9.tar.gz (31.5 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.9-cp39-abi3-win_amd64.whl (256.6 kB view details)

Uploaded CPython 3.9+Windows x86-64

agdr_aki-1.8.9-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.9-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.9.tar.gz.

File metadata

  • Download URL: agdr_aki-1.8.9.tar.gz
  • Upload date:
  • Size: 31.5 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.9.tar.gz
Algorithm Hash digest
SHA256 abe7dbd36842420954adb3cd72d69ebba8198f69b31c047c3aa8e258ecc845de
MD5 5fa53bd3412a9732ef5af6a0581c5475
BLAKE2b-256 23e62edd3c9f282aabeda3fdb8946db6fbb6603742ac5a69758a170bb8de2d72

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: agdr_aki-1.8.9-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.9-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 7365221f43048cf324b4b5221acdcf903e1b3e97a8cd5c66ad44cc3c7345a2cb
MD5 b0f1f0add103f8c25308425ce7e88ce7
BLAKE2b-256 9fd3f0a82eda7bb858ecf25feca2034630c89abf0033b1f8814b2160d0243574

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for agdr_aki-1.8.9-cp39-abi3-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 f962691eeefa5617a83cab2c906d967f94f74d7365414f4ac397a74fae0c714c
MD5 598c65402e9f2c7e189390b61355415a
BLAKE2b-256 ae43e7ee55bd85a450193ad6dcc6382e253ff338a25c84be00c28090ec5f6950

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for agdr_aki-1.8.9-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 67acdfab49eec71f2a1eeb5d40222ab8cd867543a060e16cd85457a5ea018edc
MD5 2a3a11d257e35f64972082644816a4f2
BLAKE2b-256 1a71c3703e2c47bf9faefefb29d4b2ec49218764078323c81978e90ee13ac133

See more details on using hashes here.

Provenance

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