Slack

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.