This release is a pre-release and may not be stable for production use.
amep-agents: AMEP evidence for agent frameworks
Record, for every tool call your agent makes, signed evidence of what it declared and what the tool actually did. Then check, offline, whether it stayed within the authority a person delegated. Supports:
- OpenAI Agents SDK: a tracing processor;
- LangGraph and LangChain: a callback handler.
The evidence format is AMEP (Agentic Mandate Evidence Protocol), an open specification with an IETF Internet-Draft. Evaluation returns one of three verdicts:
preserved;violated, naming the broken invariant;unresolved, meaning evidence is missing. This is never permission.
pip install --pre "amep-agents[openai-agents]" # or "amep-agents[langgraph]"
How it works
You describe your tools once:
from amep_agents import Effect
def interpret(tool, args): # what a call declares
if tool == "update_ticket":
return Effect("tickets.update", f"tickets:issue/{args['ticket_id']}", "write_shared", reversible=True)
if tool == "get_ticket":
return Effect("tickets.read", f"tickets:issue/{args['ticket_id']}", "read")
return None # not governed: no evidence
def executed(tool, args, output): # optional: what the tool reports it actually did
if tool == "update_ticket":
return Effect("tickets.update", f"tickets:issue/{output['updated']}", "write_shared", reversible=True)
return interpret(tool, args)
The recorder then emits:
- a host-signed invocation for each governed call;
- an observer-signed receipt when the call finishes.
A tool that fails gets no receipt, so its call evaluates to unresolved, never preserved.
from amep_protocol import sdk
from amep_agents import EvidenceRecorder
recorder = EvidenceRecorder(
host_key, observer_key, # sdk.Key with roles "host" and "observer"
authority_ref="d-1", # the mandate or delegation the agent acts under
interpret=interpret, executed=executed,
chain=[mandate, delegation], # the signed authority objects
actor="agent:support-bot",
)
OpenAI Agents SDK
from agents import add_trace_processor
from amep_agents.openai_agents import AmepTracingProcessor
add_trace_processor(AmepTracingProcessor(recorder))
result = await Runner.run(agent, "close ticket 4821")
verdict, results = recorder.evaluate(sdk.keyset(issuer_key, host_key, observer_key))
LangGraph and LangChain
from amep_agents.langchain import AmepCallbackHandler
handler = AmepCallbackHandler(recorder)
graph.invoke(inputs, config={"callbacks": [handler]})
verdict, results = recorder.evaluate(keys)
What it catches
| Situation | Verdict |
|---|---|
| Tool did what the agent declared, within the delegation | preserved |
| Tool changed something other than what was requested | violated, I2 |
| Agent acted on a resource outside its delegation | violated, I2 |
| A delegation is wider than its parent, or was revoked before the call | violated, I1 or I6 |
| Tool failed, or reported nothing | unresolved, I7 |
Keys and trust
- Keep the observer key away from the agent. It should live in the tool runtime or a proxy, so that high-impact effects are observed by someone other than the actor (I10). In-process hooks give assurance level L1.
- Stronger assurance: for L2 or L3, have the tool server sign its own receipts, for example with the MCP extension in
prototypes/mcp-amep-evidence. - Checking a packet:
recorder.packet()is a plain JSON packet. Anyone can check it withamep-protocol verify, theamep-mcpserver, or the browser verifier.
Links
- Specification · IETF Internet-Draft
- Source and tests:
packages/agents
Licensed under Apache 2.0. AMEP is a trademark of Staford Titus Selvaraj.
Metadata
Release files for amep-agents 0.1.0a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| amep_agents-0.1.0a1.tar.gz | 14.2 kB | With provenance | Details for amep_agents-0.1.0a1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| amep_agents-0.1.0a1-py3-none-any.whl | Python 3 | none | any | Details for amep_agents-0.1.0a1-py3-none-any.whl |
Total release size: 26.9 kB
Release files / amep_agents-0.1.0a1.tar.gz
| Download URL | amep_agents-0.1.0a1.tar.gz |
|---|---|
| Size | 14.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
25c0b6332a81758dca9a9a79bf77b81fb46cad021514846bdfefd97f2fe30ed1
|
|
BLAKE2b-256 checksum How to use checksums |
defd4d1d06bc8641c981914db6aaf7295b1db59272c01e17087d4918dc076b8f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.
Transparency logRelease files / amep_agents-0.1.0a1-py3-none-any.whl
| Download URL | amep_agents-0.1.0a1-py3-none-any.whl |
|---|---|
| Size | 12.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b004adeda50ca9afcc729c4b891c148979f01b8f6d26fa1b3f5fc8c11e85bfca
|
|
BLAKE2b-256 checksum How to use checksums |
d4deeef5d04bc2ff3ebb45066fb9fbc8ac1c2618618d76206f27b68c1416ff57
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.
Transparency logSecurity for amep-agents 0.1.0a1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for amep_agents-0.1.0a1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.