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.2.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.2-py3-none-any.whl (14.2 kB view details)

Uploaded Python 3

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

Hashes for pic_standard-0.1.2.tar.gz
Algorithm Hash digest
SHA256 f3013cfbc60261ac5f458f6008a07be5d828ad5df7fc6f044aaf60588def2220
MD5 6f451a4dbaeb0f61802fc80fd4b51c8d
BLAKE2b-256 e790ce3986213fb5bdd7efe1b6282363779da8c4725d2ac236e60650dee74d4e

See more details on using hashes here.

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

Hashes for pic_standard-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2454ca2ce6f7dcf631c448d9621a8fd4ffcdcb47303d85c8413aacfc2323c9e4
MD5 50b5d000ce3489da38684a642dd67b4c
BLAKE2b-256 55abc89bde7fc877c74aa957c5c7de2a765d92f0a4bcc7f5b24585c18499b906

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