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.19.4.tar.gz (124.6 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.19.4-py3-none-any.whl (67.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for 3tears_channels-0.19.4.tar.gz
Algorithm Hash digest
SHA256 7e08435ecc5ef0713b271a230e642189adc92a2dbd0e593d9f20f431e2ad7416
MD5 b6c744314262260343ac6e4b9e4379c5
BLAKE2b-256 138fa3c90b24c6e45a14cdf686bd90dede77293dc31254a405098c53b4fbd3a0

See more details on using hashes here.

Provenance

The following attestation bundles were made for 3tears_channels-0.19.4.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.19.4-py3-none-any.whl.

File metadata

File hashes

Hashes for 3tears_channels-0.19.4-py3-none-any.whl
Algorithm Hash digest
SHA256 3e0022fa9e5b5579d2b31b72f5821e4b60acdc1e4623dfd1486187899144545b
MD5 dec0679171cecef57eeb8b94e997f28f
BLAKE2b-256 d7e839927a917a48562c8366ae0987dab2e53f2f695db53d80a9306689679ea8

See more details on using hashes here.

Provenance

The following attestation bundles were made for 3tears_channels-0.19.4-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