Skip to main content

PACT Platform

License Python Tests

Human judgment surface for governed AI operations.

PACT Platform is a Layer 3 application built on kailash-pact governance primitives and kaizen-agents autonomous execution. It provides the org definition, approval UX, work management, dashboard, and deployment that turn governance rules into an operational system.

Not a generic agent orchestrator. Every agent action passes through a governance pipeline -- D/T/R accountability, operating envelopes, knowledge clearance, and verification gradient -- before execution.


Quick Start

pip install pact-platform[all]
pact quickstart --example university

This loads the university demo org, registers 3 agents, seeds sample data, and starts the API server at http://localhost:8000.

What you'll see:

  • Dashboard at http://localhost:3000 -- objectives, requests, approvals, cost tracking
  • 1 HELD action in the approval queue (researcher needs CONFIDENTIAL clearance)
  • $0.10 total cost across 3 demo agent runs
  • API at http://localhost:8000/docs -- 42+ endpoints

Architecture

┌─────────────────────────────────────────────────────┐
│  L3: pact-platform (this package)                   │
│  ┌────────┐ ┌────────┐ ┌─────┐ ┌──────────────┐    │
│  │ Models │ │ API    │ │ CLI │ │ Integrations │    │
│  │ (11)   │ │ (42+)  │ │     │ │ Slack/Teams  │    │
│  └────────┘ └────────┘ └─────┘ └──────────────┘    │
│  ┌─────────────────────────────────────────────┐    │
│  │ Engine: Envelope Adapter, Governed Delegate, │    │
│  │ Approval Bridge, Supervisor Orchestrator     │    │
│  └─────────────────────────────────────────────┘    │
├─────────────────────────────────────────────────────┤
│  L2: kaizen-agents (GovernedSupervisor)             │
├─────────────────────────────────────────────────────┤
│  L1: kailash-pact (GovernanceEngine, D/T/R grammar) │
│  L1: kailash[trust] (EATP SDK, trust chains)        │
│  L1: kailash-dataflow (auto-generated CRUD nodes)   │
├─────────────────────────────────────────────────────┤
│  L0: Kailash Core SDK (workflow runtime, 140+ nodes) │
└─────────────────────────────────────────────────────┘

Key Concepts

Concept What it means
D/T/R Grammar Department → Team → Role. Every address resolves to exactly one governance envelope.
Operating Envelope Five constraint dimensions: Financial, Operational, Temporal, Data Access, Communication.
Knowledge Clearance Five levels: PUBLIC → RESTRICTED → CONFIDENTIAL → SECRET → TOP_SECRET.
Verification Gradient Four zones: AUTO_APPROVED → FLAGGED → HELD → BLOCKED.
GovernedSupervisor Autonomous agent execution within governance constraints.

CLI Reference

pact quickstart --example university   # Demo with seeded data
pact org create my-org.yaml            # Load org from YAML
pact org list                          # List compiled orgs
pact role assign D1-T1-R1 agent-001    # Assign agent to role
pact clearance grant D1-T1-R1 CONFIDENTIAL  # Grant clearance
pact bridge create D1-R1 D2-R1         # Cross-functional bridge
pact envelope show D1-T1-R1            # Show effective envelope
pact agent register agent-001 D1-T1-R1 # Register agent
pact audit export --format json        # Export audit trail

API Endpoints

Group Prefix Endpoints
Objectives /api/v1/objectives create, list, detail, update, cancel, requests, cost
Requests /api/v1/requests submit, list, detail, cancel, sessions, artifacts
Sessions /api/v1/sessions list, detail, pause, resume
Decisions /api/v1/decisions list, detail, approve, reject, stats
Pools /api/v1/pools create, list, detail, add/remove members, capacity
Reviews /api/v1/reviews list, detail, add finding, finalize
Metrics /api/v1/platform/metrics cost, throughput, governance, budget
Governance /api/v1/ teams, agents, envelopes, trust-chains, bridges, etc.

Docker Deployment

docker compose up

Services:

  • api — FastAPI server (port 8000)
  • web — Next.js dashboard (port 3000)

Development

git clone https://github.com/terrene-foundation/pact.git
cd pact
pip install -e ".[all,dev]"
pytest  # 1838 tests

License

Apache 2.0 — Terrene Foundation (Singapore CLG). Fully independent, irrevocably open.

The Quartet

Standard Purpose License
CARE Governance philosophy (Dual Plane Model) CC BY 4.0
PACT Architecture (D/T/R, envelopes, clearance, gradient) CC BY 4.0
EATP Protocol (trust chains, delegation, verification) CC BY 4.0
CO Methodology (human-AI collaboration) CC BY 4.0

Metadata

Release files for pact-platform 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pact-platform 0.3.0
File Size Uploaded
pact_platform-0.3.0.tar.gz 279.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pact-platform 0.3.0
File Interpreter ABI Platform
pact_platform-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 624.1 kB

Release files / pact_platform-0.3.0.tar.gz

Download URL pact_platform-0.3.0.tar.gz
Size 279.6 kB
Tags Source
SHA-256 checksum
How to use checksums
ee946c4e53d1ee66d78e993e0efad51ccc7924c215be95ff57b55e8485fc4d8c
BLAKE2b-256 checksum
How to use checksums
269e0e1c65d9a08d62cf722c9c714c7333a077768f8b43cbed4e6a63947513d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 24, 2026.

Transparency log

Release files / pact_platform-0.3.0-py3-none-any.whl

Download URL pact_platform-0.3.0-py3-none-any.whl
Size 344.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c74065ecb90c0c9ba49d7c6c0f8d5f6084ef281f4be380829f91caccb18d0692
BLAKE2b-256 checksum
How to use checksums
74049d07604f29f502fd011ac6c9e24e6dbc29928d0735e02e06e274f9e7b38b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 24, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page