Skip to main content
Pre-release

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 with amep-protocol verify, the amep-mcp server, or the browser verifier.

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)

Source distribution for amep-agents 0.1.0a1
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)

Table of built distributions (wheels) for amep-agents 0.1.0a1
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page