Historical repository.

This repository reflects an earlier design line and is no longer the current implementation track.

Current versions:

• JEP v0.6: https://github.com/hjs-spec/jep-v06
• JEP API v0.6: https://github.com/hjs-spec/jep-api
• HJS v0.5: https://github.com/hjs-spec/hjs-05
• JAC v0.5: https://github.com/hjs-spec/jac-agent-02

JEP-Agent SDK 1.0

Historical tracing SDK with explicit instrumentation and local verification.

JEP-Agent SDK is an experimental implementation of the Judgment Event Protocol (JEP-04) and JAC-01. It records instrumented calls using the historical event format. A configured signing key and independently trusted verification key are required for signature assurance.

Install

pip install jep-agent-sdk

With framework adapters:

pip install jep-agent-sdk[langchain,openai]

For current MCP and OpenAI Agents integrations, use jep-mcp-wrapper and jep-openai-agents-middleware. This repository retains legacy adapters.

30-Second Quickstart

from jep import trace
from jep.recorder import record
from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PrivateKey

trace.enable(issuer="did:example:agent-001", private_key=Ed25519PrivateKey.generate())

@record(issuer="did:example:agent-001", chain=trace.chain)
def my_agent(query: str) -> str:
    return f"Result for {query}"

my_agent("hello")
trace.view()   # See the J/D/T/V event chain in your terminal

Legacy framework adapters

Causal Web Viewer

jep web --port 8080

Drag-and-drop your events.jsonl. Get an interactive force-directed causal graph. Click any node to inspect the full JEP event. Pan, zoom, export.

Determinability Guard — Stop Agents from Guessing

from jep.determinability import DeterminabilityGuard

guard = DeterminabilityGuard(
    evidence_fn=lambda ctx: len(ctx.get("tools_used", [])),
    target_fn=lambda ctx: ctx.get("outcome"),
    knowledge_base=[{"tools_used": ["search", "calc"], "outcome": 1},
                    {"tools_used": ["search"], "outcome": 0}],
    on_insufficient="raise",
)

@guard.require_determinable
def my_agent(query: str, tools_used: list) -> str:
    ...

What it does: If your agent hasn't gathered enough evidence to make a deterministic decision, the guard blocks execution and tells you exactly what's missing. This is an application-defined gate; it does not guarantee factual accuracy.

CLI Tools

# Verify signatures, chains, and anti-replay
jep verify events.jsonl --public-key key.pem

# Export a full compliance report (HTML with embedded causal graph)
jep export events.jsonl --output report.html

What is JEP?

JEP (Judgment Event Protocol) is a minimal log format proposed in an individual IETF Internet-Draft for AI agent decisions. It defines four immutable verbs:

Signing is optional at recording time. Unsigned events are unverified. This historical format uses its own embedded JWS payload and hash links; use jep-v06 for the current detached JWS/JCS conformance baseline.

Project Structure

jep/
├── core/           # JEP-04 protocol engine (event, crypto, verifier, chain)
├── primitives.py   # J/D/T/V convenience wrappers
├── recorder.py     # @record decorator + global trace manager
├── determinability.py  # Causal sufficiency gate (DeterminabilityGuard)
├── extensions/
│   └── jac.py      # JAC-01 cross-agent accountability
├── adapters/
│   ├── langchain.py      # TRUE zero-code auto-patch
│   ├── openai_agents.py  # TRUE zero-code auto-patch
│   └── mcp.py            # MCP server wrapper
├── cli/
│   └── main.py     # jep web | jep verify | jep export
└── web/
    └── static/
        └── index.html   # Drag-and-drop causal topology viewer

Documentation

• Architecture & Design Principles
• API Reference
• JEP-04 Internet-Draft
• JAC-01 Internet-Draft

Contributing

git clone https://github.com/hjs-spec/jep-agent-sdk.git
cd jep-agent-sdk
make install
make test

See CONTRIBUTING.md.

Author

Yuqiang Wang
HJS Foundation Ltd.
Email: signal@humanjudgment.org
GitHub: @hjs-spec

JEP-Agent SDK is released under BSD-3-Clause. The protocol draft is an individual IETF Internet-Draft and does not represent IETF endorsement.