A provenance-aware context protocol for multi-agent AI systems, designed for EU AI Act compliance. jhcontext defines how AI agents exchange, audit, and prove the integrity of context — from specification to production deployment.
jhcontext-protocol
(JSON-LD specification)
│
▼
jhcontext-sdk
(Python SDK on PyPI)
╱ ╲
▼ ▼
jhcontext-usecases jhcontext-crewai
(in-memory POC) (AWS production)
~25 ms, no infra Lambda + DynamoDB + S3
| Repository | What it is | Start here |
|---|---|---|
| jhcontext-protocol | JSON-LD specification (v0.3). Defines the envelope structure, artifact schemas, forwarding policies, and W3C PROV provenance mappings. | jhcontext-core.jsonld |
| jhcontext-sdk | Python SDK. EnvelopeBuilder, ForwardingEnforcer, StepPersister, PROV graph builder, PII tokenization, audit functions, FastAPI server, and MCP server. | pip install jhcontext |
| jhcontext-usecases | Lightweight proof-of-concept. Healthcare (Art. 14 temporal oversight) and Education (Art. 13 negative proof) scenarios with a 7-benchmark suite. Runs in ~25 ms, no infrastructure needed. | python -m usecases.run |
| jhcontext-crewai | Production deployment on AWS. CrewAI multi-agent flows for Healthcare, Education, Recommendation, and Finance with Chalice Lambda API, DynamoDB, and S3 storage. | docs/architecture.md |
An envelope is a context container that travels between AI agents. It carries:
- Semantic payload structured in four UserML layers (observation, interpretation, situation, application)
- Artifacts tracking every computational product (model outputs, embeddings, tool results)
- Forwarding policy with monotonic enforcement — once set to
semantic_forward(HIGH-risk), raw context is permanently filtered - W3C PROV graph linking entities, activities, and agents across the pipeline
- Cryptographic proof via URDNA2015 canonicalization, SHA-256 hashing, and Ed25519 signatures
- Privacy and compliance blocks for PII tracking and regulatory metadata
Four auditable operations, each demonstrated end-to-end in the usecases and crewai repos:
| Pattern | EU AI Act | What it proves |
|---|---|---|
| Temporal oversight | Art. 14 | A human reviewed AI output after the recommendation, with verifiable timestamps |
| Negative proof | Art. 13 | Protected attributes (identity, disability) were absent from the decision chain |
| Workflow isolation | Art. 13 | Parallel workflows (e.g., grading vs. equity) shared zero PROV entities |
| Integrity verification | General | SHA-256 hash and Ed25519 signature over canonical JSON-LD remain valid |
pip install jhcontextfrom jhcontext import EnvelopeBuilder, RiskLevel, ArtifactType, observation, userml_payload
payload = userml_payload(
observations=[observation("user:alice", "temperature", 22.3)],
)
env = (
EnvelopeBuilder()
.set_producer("did:example:agent-1")
.set_scope("healthcare")
.set_risk_level(RiskLevel.HIGH) # auto-sets forwarding_policy=semantic_forward
.set_human_oversight(True)
.set_semantic_payload([payload])
.sign("did:example:agent-1")
.build()
)jhcontext.com ・ YouTube ・ Substack ・ X ・ Threads
jhcontext is a research project — reference implementation of PAC-AI, a provenance-aware context protocol.