Skip to main content

Unified message protocol for channel adapters in the 3tears platform

Project description

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.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

3tears_channels-0.17.6.tar.gz (121.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

3tears_channels-0.17.6-py3-none-any.whl (66.4 kB view details)

Uploaded Python 3

File details

Details for the file 3tears_channels-0.17.6.tar.gz.

File metadata

  • Download URL: 3tears_channels-0.17.6.tar.gz
  • Upload date:
  • Size: 121.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for 3tears_channels-0.17.6.tar.gz
Algorithm Hash digest
SHA256 9f03fddc16399087ad3c4580539cce48f63f6b26000742e616ee609eced5745a
MD5 eddc9bc909a7757f3b896ad67d92ed96
BLAKE2b-256 ef850e85b7dbb26a62611c7158e8c53059781c41f46e8b7b2879b597d1c9a3d9

See more details on using hashes here.

Provenance

The following attestation bundles were made for 3tears_channels-0.17.6.tar.gz:

Publisher: release.yml on pacepace/3tears

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file 3tears_channels-0.17.6-py3-none-any.whl.

File metadata

File hashes

Hashes for 3tears_channels-0.17.6-py3-none-any.whl
Algorithm Hash digest
SHA256 3c980cc68b4c16c223a7e1937c3545b2030fd881ba95b3fe964d21c11dbf46d8
MD5 975170edf6cd98b03f2deac58a8f9b0f
BLAKE2b-256 101e620b23708358beac9acde3e049d8191ad42f3af52c6c5789d1e3f9b67f85

See more details on using hashes here.

Provenance

The following attestation bundles were made for 3tears_channels-0.17.6-py3-none-any.whl:

Publisher: release.yml on pacepace/3tears

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page