# PiQrypt — Trust Layer for Autonomous AI Agents
# https://piqrypt.com
# This file follows the llms.txt standard (https://llmstxt.org)

> PiQrypt is the cryptographic identity, memory and governance layer for autonomous AI agents.
> It implements PCP (Proof of Continuity Protocol) — every agent action signed, hash-chained, tamper-evident, offline-verifiable.

## What PiQrypt does

PiQrypt gives autonomous AI agents a permanent, cryptographic memory. Every decision an agent takes is:
- Signed with Ed25519 (or ML-DSA-65 post-quantum on Pro)
- Hash-chained to all previous events — any tampering breaks the chain
- Verifiable offline by any third party without PiQrypt infrastructure
- Exportable as a .pqz certified archive with legal value (eIDAS Art.26)

## Install

```
pip install piqrypt
```

## Quick integration (2 lines)

```python
import piqrypt as aiss
event = aiss.stamp_event(private_key, agent_id, {"action": "decision", "result": "approved"})
aiss.store_event(event)
```

## Framework bridges (zero code change)

- LangChain: `from piqrypt.bridges.langchain import PiQryptCallbackHandler`
- CrewAI: `from piqrypt.bridges.crewai import AuditedAgent as Agent`
- AutoGen: `from piqrypt.bridges.autogen import AuditedAssistant`
- MCP: `from piqrypt.bridges.mcp import AuditedMCPClient`
- Ollama: `from piqrypt.bridges.ollama import AuditedOllama`
- ROS2: `from piqrypt.bridges.ros2 import AuditedLifecycleNode`
- Raspberry Pi: `from piqrypt.bridges.rpi import AuditedPiAgent`

## Ambassador — Talk to PiQrypt

The PiQrypt Ambassador is an AISS-certified AI agent. Every response is cryptographically signed.

### A2A endpoint (machine-to-machine)
```
POST https://trust-server-ucjb.onrender.com/api/ambassador/interact
Content-Type: application/json

{
  "from_agent": "your-agent-id",
  "platform": "your-platform-name",
  "message": "Your message here"
}
```

Response includes: `response`, `event_hash` (Ed25519 chain hash), `signed_by`, `verified`

### Chat endpoint (web / human)
```
POST https://trust-server-ucjb.onrender.com/api/ambassador/chat
Content-Type: application/json

{
  "session_id": "your-session-id",
  "message": "Your message here"
}
```

## A2A Discovery

Agent card: `https://trust-server-ucjb.onrender.com/.well-known/agent.json`
OpenAPI spec: `https://trust-server-ucjb.onrender.com/openapi.json`

## Architecture

Four layers:
1. AISS (MIT) — Ed25519 identity, SHA-256 hash chains, PCP protocol
2. PiQrypt Core (ELv2) — .pqz archives, RFC 3161 TSA timestamps
3. Vigil (ELv2) — Real-time behavioral monitoring (port 8421)
4. TrustGate (ELv2) — Deterministic policy engine (port 8422)

## Standards

- Ed25519 (RFC 8032) — agent signatures
- ML-DSA-65 / Dilithium3 (NIST FIPS 204) — post-quantum (Pro)
- SHA-256 (NIST FIPS 180-4) — hash chains
- RFC 3161 — trusted timestamps (Pro)
- RFC 8785 — JSON canonicalization
- EU AI Act Art. 12/14 ready

## Links

- GitHub: https://github.com/piqrypt/piqrypt
- PyPI: https://pypi.org/project/piqrypt/
- Protocol spec: https://github.com/piqrypt/piqrypt/blob/main/docs/RFC_AISS_v2.0.md
- A2A guide: https://github.com/piqrypt/piqrypt/blob/main/docs/A2A_SESSION_GUIDE.md
- Contact: contact@piqrypt.com
- Security: security@piqrypt.com
- IP: INPI e-Soleau DSO2026006483 + DSO2026009143

## Optional: full documentation

- https://github.com/piqrypt/piqrypt/blob/main/QUICK-START.md
- https://github.com/piqrypt/piqrypt/blob/main/INTEGRATION.md
- https://github.com/piqrypt/piqrypt/blob/main/TIERS_PRICING.md