How physics0070/actionproof works
ActionProof is an evidence-verified safety gateway for AI-agent writes. Its main workflow intercepts an MCP request, checks cited and derived claims, obtains a policy decision, then commits an approved action once and records the outcome. REVIEW requests branch to a human console; the README also documents a proxy, LangChain adapter, audit verification, and an evaluation harness. Some console and evaluation internals were not sampled, so those connections are shown only where documented.
Main entry points: gate.py Action Gate · server.py MCP Server · review.py Review Workflow · verify.py Claim Verification
Components 20
Request Gateway
- MCP Server
src/actionproof/server.py - Request Contracts
src/actionproof/contracts.py - Action Gate
src/actionproof/gate.py
Verification and Assurance
- Document Extraction
src/actionproof/extract.py - Claim Verification
src/actionproof/verify.py - OPA Policy
src/actionproof/policy.py - Receipt Signing
src/actionproof/signing.py - PostgreSQL State
src/actionproof/db.py - Audit Chain
src/actionproof/audit.py
Human Review
- Review Workflow
src/actionproof/review.py - Console API
src/actionproof/console.py - Review Console
web/components/console/RequestView.tsx - Web API Client
web/lib/api.ts
Integrations and Evaluation
- MCP Proxy
src/actionproof/proxy.py - LangChain Adapter
src/actionproof/adapters/langchain.py - Product Site
web/components/site/Story.tsx - Evaluation Cases
eval/cases.py - Evaluation Harness
eval/run.py
Other components
- AI Agent
- OPA Service
Connections 20
- AI Agent → MCP Server: submits calls
README.md - MCP Server → Request Contracts: parses request
src/actionproof/server.py - MCP Server → Action Gate: prepares action
src/actionproof/server.py - Action Gate → Claim Verification: verifies claims
src/actionproof/gate.py - Claim Verification → Document Extraction: re-extracts evidence
src/actionproof/verify.py - Action Gate → OPA Policy: requests decision
src/actionproof/gate.py - OPA Policy → OPA Service: queries policy
README.md - Action Gate → Receipt Signing: signs receipts
src/actionproof/gate.py - Action Gate → PostgreSQL State: rechecks and commits
README.md - Action Gate → Audit Chain: records outcomes
src/actionproof/gate.py - MCP Server → Review Workflow: parks review
src/actionproof/server.py - Review Workflow → PostgreSQL State: stores review state
src/actionproof/review.py - Review Workflow → Action Gate: approves and commits
src/actionproof/review.py - Console API → Review Workflow: decides review
src/actionproof/review.py - Review Console → Web API Client: requests console data
- Web API Client → Console API: calls console API
README.md - MCP Server → MCP Proxy: starts proxy mode
src/actionproof/server.py - LangChain Adapter → Action Gate: wraps tool actions
src/actionproof/adapters/langchain.py - Evaluation Harness → Evaluation Cases: loads cases
- Product Site → AI Agent: explains product
README.md