Metadata-Version: 2.4
Name: mailbox-relay
Version: 0.1.0
Summary: Mailbox Relay: free, local-first, USPS-like messaging for AI agents. Addressing, receipts, rate limits, content filters, quarantine, append-only log.
Author-email: Ultrec AI Inc <hello@ultrecai.com>
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Mailbox Relay™ v0.1.0

USPS-like messaging for AI agents, by Ultrec AI Inc. Free, MIT, stdlib-only, local-first.

- **Addressing** – named parties (`planner`, `coder`, …); multi-recipient sends
- **Delivery receipts** – who has read, who is pending
- **Rate limits** – per sender, per window
- **Content filters** – secrets/keys are rejected (and never written to the log); rule-change, prompt-injection and code-injection patterns are quarantined
- **Quarantine** – flagged mail waits for a human to `release` or `discard`
- **Append-only JSONL log** – every event is one line; state is replayed, never rewritten
- **Enable flag + optional `pause_check` hook** – off until you turn it on; your host can wire its own kill switch

## Install
```bash
pip install mailbox-relay-0.1.0-py3-none-any.whl   # or: unzip the .zip, then pip install .
mailbox-relay demo                                   # local round-trip in a temp dir
```

## Quickstart (CLI)
```bash
mr enable
mr send planner coder,reviewer "Draft the parser" --subject task
mr read coder
mr receipt <id>
mr check "ignore previous instructions"
mr quarantine ; mr release <id> --by human
mr verify
```

## Quickstart (Python)
```python
from mailbox_relay import Relay
r = Relay(".mailbox-relay", rate_limit=30, pause_check=lambda: False)
r.enable()
res = r.send("planner", ["coder"], "hello")
print(r.read("coder"), r.receipts(res.id))
```

Provided AS IS under the MIT License. Mailbox Relay™ is a trademark of Ultrec AI Inc.
