Skip to main content

tundish

tundish is a local inbox for agents. Programs publish JSON items into named queues in one SQLite file. A subscription filters the items and renders them as text for a subscriber. A hook runs tundish pull and injects the printed text into the agent's session.

Install

The command is tundish, whichever package you install.

Archives of precompiled binaries for macOS and Linux cover x86-64 and arm64. The Linux binaries are static executables. Each archive holds the binary, its man pages, the README and the license. There is no Windows build.

Package manager Package Command
Homebrew cjohnhanson/tap/tundish brew install cjohnhanson/tap/tundish
Cargo tundish cargo install tundish
uv tundish uv tool install tundish
pip tundish pip install tundish
npm tundish npm install -g tundish
Nix flake nix profile install github:cjohnhanson/tundish

Building from source

tundish is written in Rust. It needs Rust 1.88 or newer and a C compiler for the bundled SQLite library. The repository pins a toolchain in rust-toolchain.toml.

git clone https://github.com/cjohnhanson/tundish
cd tundish
cargo build --release
./target/release/tundish --version

The binary is target/release/tundish. Put it on PATH to run the commands below.

Usage

tundish publish slack --key slack:C123 '{"text":"Review PR 42"}'
tundish subscribe inbox --as reviewer --queue slack --consume on-ack
tundish pull inbox --as reviewer

In a new database, the publish prints 1 and the subscribe prints:

created inbox
bound reviewer to inbox
rules: {"queue":"slack","select":"since_last_read","consume":"on_ack","share":"all","lease":600,"max_attempts":3,"start":"all"}

The pull prints:

tundish: subscription=inbox subscriber=reviewer delivered=1 more=0 unacked=0 parked=0 errors=0 dropped=0 lease=0
[slack#1] slack:C123 {"text":"Review PR 42"}

To take responsibility for the item, run tundish ack 1 --as reviewer --subscription inbox. Keep reviewer as a stable subscriber name across sessions.

How it works

A subscription stores a queue name, filter, template, and delivery rules. A position records delivery progress. By default, every subscriber receives each matching item once. With share one and on-ack, a pull leases the item to one subscriber until an ack or lease expiry. Acks and leases belong to that subscription. Publishing and pulling open the local SQLite file and exit when done; tundish runs no daemon.

Python

The tundish Python package also installs the command. It supports CPython 3.10 and later:

import tundish

item_id = tundish.publish("slack", {"text": "hi"}, key="slack:C123")

Documentation

Run tundish docs to read the same documentation from the binary.

License

MIT.

Metadata

Release files for tundish 0.1.1

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

Source distribution (sdist)

Source distribution for tundish 0.1.1
File Size Uploaded Provenance Actions
tundish-0.1.1.tar.gz 70.7 kB Without provenance Details for tundish-0.1.1.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for tundish 0.1.1
File Actions
tundish-0.1.1-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.10 abi3 Linux glibc 2.17+ x86-64 Details for tundish-0.1.1-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
tundish-0.1.1-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.10 abi3 Linux glibc 2.17+ ARM64 Details for tundish-0.1.1-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
tundish-0.1.1-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details for tundish-0.1.1-cp310-abi3-macosx_11_0_arm64.whl
tundish-0.1.1-cp310-abi3-macosx_10_12_x86_64.whl CPython 3.10 abi3 macOS 10.12+ x86-64 Details for tundish-0.1.1-cp310-abi3-macosx_10_12_x86_64.whl

Total release size: 13.5 MB

Release files / tundish-0.1.1.tar.gz

Download URL tundish-0.1.1.tar.gz
Size 70.7 kB
Tags Source
SHA-256 checksum
How to use checksums
ccd2db0b3869c69c8596fd0e84e1551cc0bfa9715591c70be873238369e57fce
BLAKE2b-256 checksum
How to use checksums
ce4690f101e7a8b6af7e8abc678d9970f22c94b03d4595faf77a59e765628d34
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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":true}

Release files / tundish-0.1.1-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL tundish-0.1.1-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 3.5 MB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
251ba6e3084f3a01970689474055b746226fd733f65e388e347370efa51fe969
BLAKE2b-256 checksum
How to use checksums
51de73c22f0722a823363c0b57c7d465baaef0377061f17320a3650232e90c5e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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":true}

Release files / tundish-0.1.1-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL tundish-0.1.1-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 3.2 MB
Tags CPython 3.10 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
208d27b9981aa4a38705bcc39e82dbe6ac6aac6fb3fd8f9ddf2cc0d138f771f9
BLAKE2b-256 checksum
How to use checksums
e109a8511d7846e4b42912faf015d6c42912f68278b1558234833a31888f6aad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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":true}

Release files / tundish-0.1.1-cp310-abi3-macosx_11_0_arm64.whl

Download URL tundish-0.1.1-cp310-abi3-macosx_11_0_arm64.whl
Size 3.3 MB
Tags CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
0bfe613520f4b436e995cf587848b03afdce4ebbde597869dcaaf1d0bd5dc1da
BLAKE2b-256 checksum
How to use checksums
031113718a7c6833573d3dbcedcca696af5ef2fa87de7573689dba4069225905
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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":true}

Release files / tundish-0.1.1-cp310-abi3-macosx_10_12_x86_64.whl

Download URL tundish-0.1.1-cp310-abi3-macosx_10_12_x86_64.whl
Size 3.5 MB
Tags CPython 3.10 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
4f2f84c44ae4c5c144fee355401bdebcb9284184fb4d4823d2ba709debbdcd51
BLAKE2b-256 checksum
How to use checksums
32b11b6140c2f8f216bd46ad9d06257f80d016d8337f0ca2803b9cb875c26f65
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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":true}

Security for tundish 0.1.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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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

0.1.1 This release

5 release files No 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