PIC Standard: Provenance & Intent Contracts for agentic side-effect governance
Project description
PIC Standard: Provenance & Intent Contracts
The Open Protocol for Causal Governance in Agentic AI.
Quickstart (60 seconds)
Option A — Install from PyPI (recommended)
Use this once
pic-standardis published on PyPI.
pip install pic-standard
Verify an example proposal:
pic-cli verify examples/financial_irreversible.json
Expected output:
✅ Schema valid
✅ Verifier passed
Validate schema only:
pic-cli schema examples/financial_irreversible.json
Expected output:
✅ Schema valid
Option B — Install from source (dev / contributors)
git clone https://github.com/madeinplutofabio/pic-standard.git
cd pic-standard
pip install -e .
pip install -r sdk-python/requirements-dev.txt
Run tests:
pytest -q
Run the CLI:
pic-cli verify examples/financial_irreversible.json
Expected output:
✅ Schema valid
✅ Verifier passed
Stability & Versioning
PIC/1.0refers to the proposal schema protocol version.- The Python package follows Semantic Versioning. Breaking changes will bump the major version.
1. The Core Thesis: Closing the "Causal Gap"
Traditional AI safety focuses on Dialogue Guardrails. However, enterprise agents operate via Side Effects (API calls, financial transfers).
The Causal Gap occurs when an agent performs a high-impact action based on instructions from an untrusted source (e.g., Indirect Prompt Injection). PIC bridges this gap by enforcing a machine-verifiable contract between Input Provenance and Action Impact.
🔍 Comparative Landscape
| Feature | CaMeL | RTBAS | PIC Standard |
|---|---|---|---|
| Primary Focus | Multi-Agent Dialogue | Physical/Robotic Safety | Business Logic & Side Effects |
| Enforcement | Cognitive/Reasoning | Sensor-based | Causal Contract (JSON Schema) |
| Target Domain | Research/Chat | Robotics | SaaS / FinTech / Enterprise |
2. Technical Glossary
- Action Proposal: A JSON contract generated by the agent before tool execution.
- Causal Taint: When an untrusted input influences a high-impact output without trusted evidence.
- Impact Class: A taxonomy of risk (e.g.,
money,privacy,compute). - Provenance Triplet: The classification of data sources into
Trusted,Semi-Trusted, orUntrusted.
3. How It Works (The Flow)
graph TD
A[Untrusted Input] --> B{AI Agent / Planner}
C[Trusted Data/DB] --> B
B --> D[Action Proposal JSON]
D --> E[PIC Verifier Middleware]
E --> F{Valid Contract?}
F -- Yes --> G[Tool Executor]
F -- No --> H[Blocked / Alert Log]
4. v1.0 Roadmap
- Phase 1 (MVP): Standardize money and privacy Impact Classes.
- Phase 2 (SDK): Reference Python/Pydantic implementation.
- Phase 3 (Integrations): Native middleware for LangGraph and CrewAI.
- Phase 4 (Advanced): Cryptographic signing for trusted provenance.
🤝 Community & Governance
The PIC Standard is an open-source movement. We are actively seeking:
- Security Researchers to stress-test causal logic.
- Framework Authors to build native PIC integrations.
- Enterprise Architects to define domain-specific Impact Classes.
Maintained by @fmsalvadori
MadeInPluto
Project details
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 pic_standard-0.1.2.tar.gz.
File metadata
- Download URL: pic_standard-0.1.2.tar.gz
- Upload date:
- Size: 17.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f3013cfbc60261ac5f458f6008a07be5d828ad5df7fc6f044aaf60588def2220
|
|
| MD5 |
6f451a4dbaeb0f61802fc80fd4b51c8d
|
|
| BLAKE2b-256 |
e790ce3986213fb5bdd7efe1b6282363779da8c4725d2ac236e60650dee74d4e
|
File details
Details for the file pic_standard-0.1.2-py3-none-any.whl.
File metadata
- Download URL: pic_standard-0.1.2-py3-none-any.whl
- Upload date:
- Size: 14.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2454ca2ce6f7dcf631c448d9621a8fd4ffcdcb47303d85c8413aacfc2323c9e4
|
|
| MD5 |
50b5d000ce3489da38684a642dd67b4c
|
|
| BLAKE2b-256 |
55abc89bde7fc877c74aa957c5c7de2a765d92f0a4bcc7f5b24585c18499b906
|