Explainability traces for agent decisions — trace format, decision trees, human-readable summaries
Project description
🔍 cocapn-explain
Agent explainability — decision traces, oversight queue, P0/P1/P2 review gates.
Install
pip install cocapn-explain
What It Does
Makes agent decisions inspectable and auditable. Every tile submission gets a trace that records the reasoning chain, confidence score, and gate outcome.
Key Features
- ExplainTrace — Records every step of an agent decision
- Oversight Queue — P0/P1/P2 priority review for sensitive operations
- Decision Audit — Replay any past decision with full context
- Gate Compliance — Verifies decisions meet deadband protocol gates
Usage
from cocapn_explain import ExplainTrace, OversightQueue
trace = ExplainTrace(agent_id="oracle1", task="tile_submit")
trace.add_step("check_confidence", value=0.92)
trace.add_step("p0_gate", outcome="accepted")
queue = OversightQueue()
queue.submit(trace)
Part of the Cocapn Fleet
- deadband-protocol — P0/P1/P2 safety gates
- plato-provenance — Zero-trust tile provenance
- plato-tile-spec — Tile specification
License
MIT
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cocapn_explain-0.2.1.tar.gz.
File metadata
- Download URL: cocapn_explain-0.2.1.tar.gz
- Upload date:
- Size: 4.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
894d78cf967ec80ec3de517a90edd22f52a3f9efb36551b2472660f472720742
|
|
| MD5 |
d0c931bc2b24b752d59a6a84ed644dec
|
|
| BLAKE2b-256 |
18175a044b92d771a086d47ec1dd63ad3d0db56f7eafb3730c4ea97a4de1c96c
|
File details
Details for the file cocapn_explain-0.2.1-py3-none-any.whl.
File metadata
- Download URL: cocapn_explain-0.2.1-py3-none-any.whl
- Upload date:
- Size: 5.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
62b2983709ced7b01fbadc0c3d654ad8d79c0334bca04a72027b5e1dcaca0248
|
|
| MD5 |
e71a04c8b0f51415f281f8765679a7d7
|
|
| BLAKE2b-256 |
0679b6bf4c650e4c4a383f8b53a0cf379c130b72de763a9685f395f9a4e3b60e
|
