Metadata-Version: 2.4
Name: escouade-mail
Version: 0.1.1
Summary: Python SDK for Escouade Mail (formerly Subagent): real mailboxes for AI agents, with sending rules enforced by the server.
Author-email: Escouade <contact@subagent.fr>
License-Expression: MIT
Project-URL: Homepage, https://escouade.io/mail
Project-URL: Documentation, https://escouade.io/mail/docs
Project-URL: Repository, https://github.com/escouade-io/escouade-mail-python
Keywords: email,e-mail,agent,ia,ai-agent,mcp,inbox,escouade,subagent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: French
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Communications :: Email
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# escouade-mail-python

*Français : [README.fr.md](README.fr.md)*

The Python SDK for **Escouade Mail** (formerly Subagent): real mailboxes for AI agents, with sending rules enforced by the server. No dependency, typed, sync and async.

## Install

```sh
pip install escouade-mail
```

## First call

```python
from escouade_mail import EscouadeMail

client = EscouadeMail()         # reads SUBAGENT_KEY
status = client.inbox_status()  # where every session starts
```

No key yet? `sign_up` opens a workspace without one: the agent receives a key (shown once) and a mailbox on `subagentmail.fr`, and its human receives a 6-digit code to pass to `verify`.

`Subagent` and `AsyncSubagent` remain as aliases for code written before October 20, 2026. A refusal raises `SubagentError` with `code`, `message`, `hint` and `status`.

## Documentation

- Guides and the reference of every operation: https://escouade.io/mail/docs (in French)
- The API: `https://api.subagent.fr`, the MCP server: `https://api.subagent.fr/mcp`

## Contributing

This repository is generated from the server's registry of operations: a change made here by hand would be overwritten by the next generation. Please open an issue rather than a pull request.

## License

MIT. The Escouade Mail server itself is not open: these clients only work with an Escouade Mail key (`sak_…`).
