| name | slack |
| description | Drive Slack from iii — expose the Slack Web API as slack::* functions (post messages, manage channels, reactions, files, users, views, search, assistant threads), configurable from the console. Anything the Slack API can do, this worker can do. |
slack
The slack worker exposes the Slack Web API as slack::* iii functions, callable
by an agent or from the console. It owns no opinion about what you do with Slack:
it is a faithful, typed surface over the API plus a generic slack::call escape
hatch for any method without a typed wrapper.
Reach for it to let an agent (or an operator) post messages, read history, react,
upload files, look up users, open modals, publish App Home, or search — using a
single configured bot token.
When to Use
- Post or edit messages, ephemeral messages, or scheduled messages in a channel,
DM, or thread (
slack::chat::*).
- List/inspect conversations and read history or thread replies
(
slack::conversations::*).
- React, pin, bookmark, upload files, look up users, or open Block Kit modals /
App Home views.
- Search messages (with a configured user token).
- Call any other Slack method via
slack::call { method, params }.
Boundaries
- The bridge (inbound
app_mention/DM → harness::send, streamed replies,
approvals) activates only when signing_secret + public_base_url are set and
the harness stack is connected. Without them the worker is API-surface-only.
- In channels the bridge acts only on an explicit @mention; DMs always trigger.
Untagged messages are captured as context, never acted on alone.
- Identity (team, workspace, bot user) is discovered via
auth.test, never
configured. Models/providers come from router::models::list — no vendor names
are baked in.
slack::search::messages needs a user_token (xoxp-); bot tokens cannot
search.
Configuration
Set bot_token (required) — and user_token for search — in the console
Configuration → Workers → slack, or seed from env (${SLACK_BOT_TOKEN}).
Run slack::config-status to validate the token and see the resolved identity.
All fields hot-reload.
Functions
Each typed function names the common Slack parameters and passes any extra
parameters through; the full Slack response payload is returned. See the
README for the full list. Use slack::call for anything not yet
typed.
