Installation

pip install aevs

With framework extras:

pip install aevs[langchain]   # LangChain / LangGraph
pip install aevs[mcp]         # Model Context Protocol

Quick Start

```python import aevs from langchain_core.tools import tool

@tool def search(query: str) -> str: """Search the web.""" return f"Results for: {query}"

aevs.configure( api_key="aevs_sk_<key_id>_<hex_secret>", agent_id="<your-agent-uuid>", ) aevs.enable()

result = search.invoke({"query": "AI news"})

refs = aevs.get_reference_ids(clear=True) print(refs)

Examples

See examples/README.md for setup instructions.

[{"seq": 1, "tool_name": "search", "reference_id": "abc-123-...", ...}]

aevs.flush() aevs.disable() ```

Credentials can also be set via AEVS_API_KEY / AEVS_AGENT_ID environment variables. If missing, the SDK logs a warning and runs in no-op mode — your agent keeps working, receipts just aren't recorded.

API Overview

aevs.configure(api_key=..., **options)   # set configuration
aevs.enable()                            # start intercepting tool calls
aevs.disable()                           # stop and restore originals
aevs.flush()                             # send buffered receipts now
aevs.get_session_id()                    # current session UUID
aevs.get_reference_ids(clear=True)       # all captured reference IDs
aevs.get_reference_id(tool_call_id)      # lookup single reference ID
aevs.is_healthy()                        # buffer write health check

See the full API reference for details.