3tears-channels

A unified message protocol for the 3tears framework, with adapters for Slack, Discord, and WebSocket clients. Write your agent logic once and deliver it across channels.

pip install 3tears-channels

What you get

One message model -- ChannelMessage, ChannelResponse, ChannelDeliveryMessage, and Attachment carry a request and its reply regardless of channel.
Routing -- ChannelRouter and StreamingChannelRouter dispatch inbound messages and stream responses back.
Slack and Discord -- payload and rich-formatting builders (build_slack_blocks, build_slack_payload, build_discord_embed, build_discord_payload) plus a should_use_rich_formatting helper.
WebSocket -- WebSocketHandler, WebSocketProtocol, a ConnectionRegistry, and frame primitives for real-time clients.
Rooms and presence -- RoomFanout, RoomState, RoomIndexCollection, and a three-tier-backed PresenceCollection with a PresenceSweeper for connection liveness.
Email -- threetears.channels.mail: Mailer over an EmailTransport, an SMTP transport reading its settings per send, EmailTemplate substitution with an HTML alternative and List-Unsubscribe headers, send_batch for many recipients with per-recipient failure isolation, and BounceReceiver for HMAC-verified delivery reports. A sibling of the channel adapters rather than one of them -- an email recipient has no conversation and usually no account, so ChannelDeliveryMessage does not apply.

Quickstart

from threetears.channels import ChannelRouter, ChannelMessage, build_slack_blocks

router = ChannelRouter(...)
response = await router.dispatch(ChannelMessage(text="hello", channel="slack", ...))

blocks = build_slack_blocks(response)

License

MIT. See LICENSE.

Release files for 3tears-channels 0.50.0

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

Source distribution (sdist)

Source distribution for 3tears-channels 0.50.0
File	Size	Uploaded
3tears_channels-0.50.0.tar.gz	166.7 kB	Sep 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for 3tears-channels 0.50.0
File	Interpreter	ABI	Platform	Reset
3tears_channels-0.50.0-py3-none-any.whl 98.6 kB Sep 23, 2026	Python 3	none	any	Details

Total release size: 265.3 kB

Release files / 3tears_channels-0.50.0.tar.gz

Download URL	3tears_channels-0.50.0.tar.gz
Size	166.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`ee17f8489f784c98df15733f79fcb2d7834447f0457fec9b0627a9e79cb8a3ee`
BLAKE2b-256 checksum How to use checksums	`088dfcc31483817653fae4900758de61f5eaf60ed1b10a4f43aecd2d2dfb7910`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pacepace/3tears
Publishing commit: github.com/pacepace/3tears/tree/d7b5fb66d001d02c291d3662f6b8162cf71bfe0e

Workflow

Publishing configuration: github.com/pacepace/3tears/blob/d7b5fb66d001d02c291d3662f6b8162cf71bfe0e/.github/workflows/release.yml
Publishing logs: github.com/pacepace/3tears/actions/runs/35917361846/attempts/1

Artifact

Subject: 3tears_channels-0.50.0.tar.gz
SHA-256 checksum: ee17f8489f784c98df15733f79fcb2d7834447f0457fec9b0627a9e79cb8a3ee Verifying attestations

Release files / 3tears_channels-0.50.0-py3-none-any.whl

Download URL	3tears_channels-0.50.0-py3-none-any.whl
Size	98.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2509ec782d10bb03cd3928e6ea1b2fcbee344fc8eae119cd6b6ad13c2f345cf1`
BLAKE2b-256 checksum How to use checksums	`5d98d4c8b065c904b0eb8aae7446edf77bee7dfb853d4013eb6f05430cb70e80`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pacepace/3tears
Publishing commit: github.com/pacepace/3tears/tree/d7b5fb66d001d02c291d3662f6b8162cf71bfe0e

Workflow

Publishing configuration: github.com/pacepace/3tears/blob/d7b5fb66d001d02c291d3662f6b8162cf71bfe0e/.github/workflows/release.yml
Publishing logs: github.com/pacepace/3tears/actions/runs/35917361846/attempts/1

Artifact

Subject: 3tears_channels-0.50.0-py3-none-any.whl
SHA-256 checksum: 2509ec782d10bb03cd3928e6ea1b2fcbee344fc8eae119cd6b6ad13c2f345cf1 Verifying attestations