reditd

What it is

In plain terms, reditd is the connector that plugs Reddit into arizuko, so the agent can watch subreddits and its inbox and reply with comments or DMs.

reditd is the Reddit channel adapter. It polls a configured list of subreddits plus the bot account’s inbox for new posts, mentions, and replies, posts them to routd, and sends outbound via the Reddit comment/submit API. JID prefix is reddit:; per-thing JIDs use Reddit’s fullname format (reddit:t1_<id> for comments, reddit:t3_<id> for posts).

Why it exists

Reddit is the only adapter on a platform with a true downvote primitive — everywhere else dislike degrades to a thumbs-down reaction or a textual reply. reditd is also where script-app OAuth lives: username + password against REDDIT_CLIENT_ID/SECRET, with cursor persistence in cursors.json so a restart doesn’t replay the inbox.

How it fits

Reddit (oauth.reddit.com)
        |  poll: /r/<sub>/new.json + /message/inbox.json
        v
      reditd     (LISTEN_ADDR=:8080)
        |  POST /v1/messages    (signed by CHANNEL_SECRET)
        v
      routd
        |  POST /send           (callback to reditd)
        v
      reditd     (POST /api/comment | /api/submit | /api/vote | /api/del | /api/editusertext)
        |
        v
      Reddit

Wired verbs (reditd/client.go): send / reply (/api/comment), post (/api/submit kind=self), like (/api/vote dir=1), dislike (/api/vote dir=-1) — the only native dislike across all adapters — delete (/api/del), edit (/api/editusertext; self-posts + comments only). send_file, forward, quote, repost are 501-with-hint.

Inbound votes are not surfaced as like events. Reddit’s API only exposes aggregate score/ups on polled things, not discrete vote events; inbox.json covers replies / mentions / PMs only. The agent sees verb=message, reply, or post for inbound.

Standalone usage

reditd is a plain Go binary. It needs a reachable routd and a Reddit script app with the bot account’s username + password.

export ROUTER_URL=http://routd:8080
export CHANNEL_SECRET=$(grep ^CHANNEL_SECRET .env | cut -d= -f2)
export LISTEN_ADDR=:8080
export REDDIT_CLIENT_ID=...
export REDDIT_CLIENT_SECRET=...
export REDDIT_USERNAME=mybot
export REDDIT_PASSWORD=...
export REDDIT_SUBREDDITS=arizuko_dev,programming
export REDDIT_USER_AGENT=arizuko/1.0
export DATA_DIR=/srv/data/arizuko_demo
./reditd

Reddit-side setup: old.reddit.com/prefs/apps → Create another app → script (not web app or installed app — script-app is what supports password grant). Set the redirect URI to anything; it’s unused. Copy client ID + secret. GET /health returns 503 when token refresh fails or the rate limit is saturated.

Go deeper

components/channels — cross-adapter verb matrix.
reditd/README.md — verb table, vote-event limitation.