Repository navigation
mailroom 0.1.0: per-agent mailbox for Discord and GitHub, read over MCP - #1
Merged
Merged
Conversation
Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
…riod Use one tick-start timestamp as last_attempt and add a 30 s slack to the due comparison (time::due). Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
- Reviews are paged 100 at a time (max 10 pages); a full last page yields a gap record. - GitHub lists that come back full and all-new yield a gap record (not on first contact). - gap records bypass rules and keep. - Discord reactions compare count_details.normal and stop refetching at the 100 cap. - The door shows a generic page for core config errors and logs the detail. - preview_urls: false in the core's wrangler config. Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
…config errors Co-Authored-By: Claude & Lothrop (cycle.five@proton.me)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this is
A mailbox per agent. A poller collects Discord and GitHub activity through the existing broker Workers and appends it to one append-only inbox per agent. When an agent wakes up it reads its mail over MCP (
read_mail,ack,mailbox_info) instead of spending inference checking Discord and GitHub directly.Design:
docs/superpowers/specs/2026-11-18-mailroom-design.md. Plan:docs/superpowers/plans/2026-11-18-mailroom.md.Shape
crates/logic(pure Rust, native tests): record and config types, filter rules, the Discord channel poller, the GitHub repo poller, the MCP JSON-RPC transport.crates/worker→ Workermailroom-core(workers-rs 0.9.0): one SQLite-backed Durable Object per agent, a once-a-minute cron tick, no public URL.door/→ Workermailroom(TypeScript): the public OAuth door. Sign in with Discord is delegated to discord-broker'sFeedentrypoint, so mailroom holds no secrets. The operator picks which agent's mailbox a grant is bound to on the consent page; the door forwards/mcpto the core with the agent taken from the grant.The brokers serve the poller through a read-only named
Feedentrypoint over service bindings: CycleFive/discord-broker#1 and CycleFive/github-broker#1 (both merged, v0.2.0).Properties
gaprecord says so, and gap records cannot be filtered away.ackmoves the cursor only forward and only over existing mail; acknowledged mail is pruned afterretain_days.Verification
cargo fmt --check,cargo clippy --workspace --all-targets -- -D warnings,cargo test --workspace(100 tests)door:npm run typecheck,npm test(22 tests)crates/worker/smoke/run.sh: the real wasm build under workerd against a fake Feed (first contact, delta, mention routing, failed poll keeps state, ack bounds, unknown agent)🤖 Generated with Claude Code
https://claude.ai/code/session_017zqkEBoTfRovHZ26Cjjc91