List configured Slack workspaces with auth type and primary status.

Returns a dict with workspaces (list of redacted profiles), primary (alias of the default workspace), and errors (config errors found at load time, e.g. malformed env values). Tokens never appear in the response.

Verify token validity per workspace + report draft store + audit log path.

For each workspace, calls auth.test. Returns user_id and team domain on success, or error code on failure. Does not retry. A failed auth.test means the token has been invalidated (logout, password change, app revoke) and needs re-extraction per SETUP.md.

List channels in the workspace.

types: comma-separated subset of public_channel, private_channel, mpim, im. Default omits DMs to keep responses short. limit caps results at the API page size.

Substring match against channel names + topics. Case-insensitive.

Read recent messages from a channel.

channel accepts ID (C12345) or name (#general). Newest first. Auto-exports the result to the vault at 🤖 AI Chats/Slack//.md (best-effort).

Read a thread's parent message and replies.

ts is the parent message timestamp (Slack message ID). channel accepts ID or name. The returned messages list includes the parent as element 0.

List users in the workspace. Excludes deleted by default.

Substring match against user real_name/display_name/email/name.

Get full profile for a user_id (U... or W...).

Search messages with Slack's full-text search.

Slack search modifiers work in query: in:#channel, from:@user, before:YYYY-MM-DD, after:YYYY-MM-DD, "exact phrase". The explicit channel param is sugar — when provided, prepends in:<channel> to the query.

Requires xoxc or xoxp auth (xoxb cannot search). Errors loudly with the workspace's actual auth_type if search isn't available.

Stage a message send. Does NOT post until confirm_send is called.

Returns a draft_id, the resolved workspace + channel, the text preview, and an expires_at unix timestamp. Drafts expire after 1 hour and can only be confirmed once.

For thread replies, set thread_ts to the parent message's ts. For replies that quote (reply with quote-block in Slack UI), use send_reply_quote instead.

Stage a reply that threads under target_ts.

Same draft+confirm semantics as send_message. The recipient sees the reply nested under the target message in their Slack UI.

Commit a previously-drafted send. Dispatches by draft.kind:

• send_message / send_reply_quote -> chat.postMessage (new message)

• update_message -> chat.update (in-place edit of target_ts)

Cancel an unconfirmed draft. Idempotent.

Add an emoji reaction to a message.

emoji is the colon-stripped name (e.g. "thumbsup", "fire", "white_check_mark"). Low-consequence write — no draft+confirm. Idempotent (Slack returns already_reacted as a soft success).

Mark a channel read up to a given message ts.

Affects unread state across all your linked devices. Use the ts of the most recent message you've read.

Delete one of your own messages.

Calls chat.delete with (channel, ts). xoxc user tokens can delete their OWN messages without special scopes. Returns ok=True on success. message_not_found is treated as a soft success (already-deleted or wrong ts).

Low-consequence (only your own messages, no destructive cascade) so no draft+confirm. The audit log records every call.

Stage an edit to one of your own messages. Does NOT update until confirm_send is called.

Fetches the current message text up front so the draft preview shows BOTH the BEFORE and AFTER strings — a visual diff in plain Python. After confirm_send, the message is edited in place via chat.update.

Returns a draft_id, the resolved workspace + channel + target_ts, and a preview dict with before, after, target_ts. Drafts expire after 1 hour and can only be confirmed once.