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.2

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.2
File Size Uploaded Provenance Actions
tundish-0.1.2.tar.gz 70.8 kB Without provenance Details for tundish-0.1.2.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for tundish 0.1.2
File Actions
tundish-0.1.2-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.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
tundish-0.1.2-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.10 abi3 Linux glibc 2.17+ ARM64 Details for tundish-0.1.2-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
tundish-0.1.2-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details for tundish-0.1.2-cp310-abi3-macosx_11_0_arm64.whl
tundish-0.1.2-cp310-abi3-macosx_10_12_x86_64.whl CPython 3.10 abi3 macOS 10.12+ x86-64 Details for tundish-0.1.2-cp310-abi3-macosx_10_12_x86_64.whl

Total release size: 13.5 MB

Release files / tundish-0.1.2.tar.gz

Download URL tundish-0.1.2.tar.gz
Size 70.8 kB
Tags Source
SHA-256 checksum
How to use checksums
432c34862d6c5abd5374f16ba9c6ce0431e38f9c82f6c4e4618c91e9b433c881
BLAKE2b-256 checksum
How to use checksums
5cdab867486b7326045ce69c6f3bba9b2482c6b9520c4a2d27062f079d3efc7c
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.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL tundish-0.1.2-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
d28141485e82ea336b7b9a6c75927e6685309cd84ac4e72d391de37c8768d42a
BLAKE2b-256 checksum
How to use checksums
16d9c53fd89e5415772878f7f1379a4ea435bd56652ff64cf604bd967cffcc7b
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.2-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL tundish-0.1.2-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
0213a50b1fc464da652ae99ad91383f3671a18f1cdf898e51b798f390e2556fb
BLAKE2b-256 checksum
How to use checksums
8775138ff8536e8b8e5c98880d248b510fdd682ddcb6a230f525061e46229c25
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.2-cp310-abi3-macosx_11_0_arm64.whl

Download URL tundish-0.1.2-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
540d95bf728d13035720ecc2c15418524f9b0c1099b10bf22a05d3f5382f1969
BLAKE2b-256 checksum
How to use checksums
0cb482e8df4fb4126a90a77a51974fceb4f4e1bf3102cc427a185ad0dfeb611d
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.2-cp310-abi3-macosx_10_12_x86_64.whl

Download URL tundish-0.1.2-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
8c1fec69bd13ca7d91470026deb2a0e48826b24587b02c7579d49d170bcdbc56
BLAKE2b-256 checksum
How to use checksums
9df113a34695ec60d4f7de778facf5b7eecf1bf0996a1f2e096bb38efb37e162
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.2

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.2 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