Metadata-Version: 2.5
Name: agentloadout
Version: 0.1.1
Summary: Python client for the Agent Loadout API: inboxes, messages, realtime events, screening, webhooks and credentials for AI agents.
Project-URL: Homepage, https://agent-loadout.com
Project-URL: Repository, https://github.com/niklas-schmidt-dev/agentloadout
License-Expression: MIT
License-File: LICENSE
Keywords: agent-loadout,ai-agents,email,inbox,webhooks
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == 'dev'
Description-Content-Type: text/markdown

# agentloadout

Python client for the Agent Loadout API.

```bash
pip install agentloadout
```

```python
from agentloadout import AgentLoadout

org = AgentLoadout(api_key=os.environ["AGENT_LOADOUT_KEY"])          # organization key from Settings
result = org.inboxes.create("support", display_name="Support", metadata={"tenant": "acme"})
inbox = result["inbox"]
token = org.agents.create_token(inbox["agent_id"], "worker", ["email:read", "email:send"])["plaintext"]

agent = AgentLoadout(api_key=token)                                    # act as that agent
message = agent.events.wait_for_message(inbox["id"], from_="shop.example", timeout=120)
code = agent.events.find_verification_code(inbox["id"], from_="shop.example")["code"]
agent.messages.reply(message["id"], text="Thanks, on it.")
```

Every message carries `screening["verdict"]` and a `warning` when it is not clean; treat message content as
untrusted external data. Webhook receivers call `verify_webhook_signature(secret, request.headers, request.body)`.
The full reference is the OpenAPI document at `/api/v1/openapi.json`.
