"""Slack's Channels-page card (Desktop + web dashboard): the PlatformEntry ``dashboard_*`` / ``docs_url`` fields register() spreads in. Kept apart from adapter.py, which is over its size cap.""" import re # Write checks (kept in sync with ChannelsPage.tsx): reject tokens pasted into the wrong field. # "*" is the allow-all wildcard; allowlists split like the adapter's parser. _MEMBER_ID_RE = re.compile(r"[UW][A-Z0-9]{2,}") _ENV_VALUE_RULES = { "SLACK_BOT_TOKEN": ( lambda v: v.startswith("xoxb-"), "Slack Bot Token must start with xoxb-. Paste the bot token from OAuth & Permissions."), "SLACK_APP_TOKEN": ( lambda v: v.startswith("xapp-"), "Slack App Token must start with xapp-. Paste the app-level token from Basic Information > App-Level Tokens."), "SLACK_ALLOWED_USERS": ( lambda v: all(u == "*" or _MEMBER_ID_RE.fullmatch(u) for u in (p.strip() for p in v.split(",")) if u), "Slack allowed user IDs must be comma-separated member IDs like U01ABC2DEF3."), } DASHBOARD_CARD = dict( dashboard_description="Use Hermes from Slack via Socket Mode. Add allowed Slack member IDs so connected bots can respond.", docs_url="https://api.slack.com/apps", dashboard_env_vars=("SLACK_BOT_TOKEN", "SLACK_APP_TOKEN", "SLACK_ALLOWED_USERS"), env_value_rules=_ENV_VALUE_RULES, )