Skip to main content
Loss of provenance

A previous release had provenance metadata, but this release does not. View details.

Multi-Agent Interface Layer (MAIL)

MAIL is a protocol and Python implementation for message-oriented coordination between humans, agents, daemons, and swarms.

This repository is being reorganized for MAIL v2. The active implementation is split into package-specific workspaces, while the older MAIL v1 reference runtime is archived under src/mail/legacy.

Active v2 Packages

  • src/mail/protocol - shared protocol types and constants (mail-protocol)
  • src/mail/server - FastAPI server implementation (mail-server)
  • src/mail/client - command-line client (mail-client)
  • src/mail/daemon - daemon implementation (mail-daemon)

Repository Layout

mail/
├── docs/                 # v2 repository-level docs
├── spec/                 # protocol specification and schemas
├── src/mail/
│   ├── protocol/         # mail-protocol package
│   ├── server/           # mail-server package
│   ├── client/           # mail-client package
│   ├── daemon/           # mail-daemon package
│   └── legacy/           # archived MAIL v1 runtime, docs, config, and UI
├── tests/                # active MAIL v2 test suite
├── scripts/              # repository maintenance scripts
└── pyproject.toml        # uv workspace and meta-package configuration

Development

Install the workspace dependencies:

uv sync

Run the v2 server:

uv run mail-server

Use the v2 client:

uv run mail --help

Run active v2 tests:

uv run pytest

During the transition, some root-level scripts still target the legacy runtime. Legacy tests and other v1 material live under src/mail/legacy.

Run archived legacy tests explicitly:

uv run --extra legacy pytest src/mail/legacy/tests

Documentation

  • Root v2 docs: docs/README.md
  • Protocol/specification: spec/
  • Server docs: src/mail/server/docs/
  • Client docs: src/mail/client/docs/
  • Legacy runtime notes: src/mail/legacy/README.md
  • Archived v1 docs: src/mail/legacy/docs/

Legacy Runtime

The MAIL v1 runtime is kept for compatibility and historical reference. Use mail.legacy.* imports for archived code as it is migrated into the legacy namespace.

Do not add new v2 behavior to the legacy runtime unless it is needed for a specific compatibility or migration task.

Licensing

Reference implementation code is licensed under Apache License 2.0. Protocol specification materials are covered by their repository license files.

Metadata

Release files for mail-swarms 2.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Loss of provenance

These files do not have provenance metadata, despite files in a prior release including this data.

We recommend further investigation before installing these files. View details.

Source distribution (sdist)

Source distribution for mail-swarms 2.0.1
File Size Uploaded Provenance
mail_swarms-2.0.1.tar.gz 70.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for mail-swarms 2.0.1
File Interpreter ABI Platform
mail_swarms-2.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 140.5 kB

Release files / mail_swarms-2.0.1.tar.gz

Loss of provenance

This file belongs to a release without provenance metadata, despite a prior release including this data.

We recommend further investigation before installing this file. View details.

Download URL mail_swarms-2.0.1.tar.gz
Size 70.3 kB
Tags Source
SHA-256 checksum
How to use checksums
556e9e8db35fe9fdaa4265142770fd2e909d724f499264229133514404d3999b
BLAKE2b-256 checksum
How to use checksums
514663f5b843c44ac8ec772434cb9f9243992c037fb8fe34e583a2a1fc28c29d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / mail_swarms-2.0.1-py3-none-any.whl

Loss of provenance

This file belongs to a release without provenance metadata, despite a prior release including this data.

We recommend further investigation before installing this file. View details.

Download URL mail_swarms-2.0.1-py3-none-any.whl
Size 70.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
079dcb7b0c65bced4af54dfc12c5e1ca23330ad8e1a77521a4a4a021572e0290
BLAKE2b-256 checksum
How to use checksums
760db0cf27563b5a8d7bf16c4467170ea6f164c462ff8a70dbd49b1933b97269
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for mail-swarms 2.0.1

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.

Loss of provenance

A previous release of these files had provenance metadata, but this release does not.

While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.

Release comparison

  • Removed 2.0.0 2 files With provenance
  • Added 2.0.1 2 files Without provenance

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

2.0.1 This release

2 release files Loss of provenance

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