Skip to main content

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.

License Status


Quickstart (60 seconds)

Option A — Install from PyPI (recommended)

Use this once pic-standard is 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.0 refers 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, or Untrusted.

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 Linkedin @fmsalvadori   GitHub MadeInPluto

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

pic_standard-0.1.1.tar.gz (17.1 kB view details)

Uploaded Source

Built Distribution

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

pic_standard-0.1.1-py3-none-any.whl (14.2 kB view details)

Uploaded Python 3

File details

Details for the file pic_standard-0.1.1.tar.gz.

File metadata

  • Download URL: pic_standard-0.1.1.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

Hashes for pic_standard-0.1.1.tar.gz
Algorithm Hash digest
SHA256 b32b28def85a853340f71f6e4645452b283a2e7e11be9cd0b2483f9032a1e162
MD5 c9cd500b7742d03cd52cdd98f7399406
BLAKE2b-256 f2aeffeefa1ce1539ef84056748f29c95c274544af0cb4b95f6487e6b60d7bdb

See more details on using hashes here.

File details

Details for the file pic_standard-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: pic_standard-0.1.1-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

Hashes for pic_standard-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 57f910e4df7e3d040b9d6384c8b78d46cbb6ff5717f94390a92d17b8d3ca4d81
MD5 dd3accb30122cfa86f5f1c39975b2475
BLAKE2b-256 07783366ae0ebdce814897c8e7c32b6fdc06746f2cd6faa522f6b275d4686634

See more details on using hashes here.

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