# agent-passport-system (Python)

> Python reference implementation of the Agent Passport System (APS) protocol, maintaining byte-parity with the TypeScript SDK. Cryptographic identity, delegation chains with monotonic narrowing, enforcement receipts, governance composition. Apache-2.0.

This is the public protocol layer in Python. Product intelligence (analytics, compliance automation, cross-tenant) lives in the private gateway, not here. Cross-language byte-parity with the TypeScript SDK is a hard invariant.

## Wave 1 accountability primitives

Ed25519 ActionReceipt, AuthorityBoundaryReceipt, CustodyReceipt, ContestabilityReceipt, APSBundle. RFC 8785 JCS canonicalized, content-addressed, byte-match across implementations.

## Install

- PyPI: `pip install agent-passport-system`
- Python 3.9+ (tested on 3.10, 3.11, 3.12)

## Canonical references

- [README.md](README.md): quick start and Python API
- [AGENTS.md](AGENTS.md): instructions for AI coding agents working on this repo
- [CLAUDE.md](CLAUDE.md): pointer to AGENTS.md for Claude Code

## Related projects

- TypeScript SDK: https://github.com/aeoess/agent-passport-system
- MCP server: https://github.com/aeoess/agent-passport-mcp
- Vocabulary: https://github.com/aeoess/agent-governance-vocabulary
- Website: https://aeoess.com
- Full project reference: https://aeoess.com/llms-full.txt

## Papers

- The Agent Social Contract: https://doi.org/10.5281/zenodo.18749779
- Monotonic Narrowing: https://doi.org/10.5281/zenodo.18932404
- Faceted Authority Attenuation: https://doi.org/10.5281/zenodo.19260073
- Behavioral Derivation Rights: https://doi.org/10.5281/zenodo.19476002
- Physics-Enforced Delegation: https://doi.org/10.5281/zenodo.19478584
- Governance in the Medium: https://doi.org/10.5281/zenodo.19582550
- Cognitive Attestation: https://doi.org/10.5281/zenodo.19646276
- The Evidence-Safety Gap: https://doi.org/10.5281/zenodo.19914628
- IETF Internet-Draft: draft-pidlisnyi-aps-00
