cli-jaw 2.2.9 → 2.2.10

package/public/js/features/settings-types.ts

@@ -3,6 +3,9 @@
 export interface PerCliConfig { provider?: string; model?: string; effort?: string; fastMode?: boolean; contextWindow?: boolean; contextWindowSize?: number; contextCompactLimit?: number; }
 export interface TelegramConfig { enabled?: boolean; token?: string; allowedChatIds?: number[]; forwardAll?: boolean; mentionOnly?: boolean; }
 export interface DiscordConfig { enabled?: boolean; token?: string; guildId?: string; channelIds?: string[]; forwardAll?: boolean; allowBots?: boolean; mentionOnly?: boolean; }
+// Slack needs TWO distinctly-scoped tokens: the bot token drives the Web API,
+// the app-level token opens the Socket Mode connection for inbound events.
+export interface SlackConfig { enabled?: boolean; botToken?: string; appToken?: string; teamId?: string; channelIds?: string[]; forwardAll?: boolean; allowBots?: boolean; mentionOnly?: boolean; replyInThread?: boolean; }
 export interface QuotaWindow {
     label: string;
     percent: number;
@@ -49,7 +52,8 @@ export interface SettingsData {
     activeOverrides?: Record<string, PerCliConfig>;
     telegram?: TelegramConfig;
     discord?: DiscordConfig;
-    channel?: 'telegram' | 'discord';
+    slack?: SlackConfig;
+    channel?: 'telegram' | 'discord' | 'slack';
     fallbackOrder?: string[];
     memory?: { cli?: string };
     projectDirs?: string[] | null;

package/public/js/features/settings.ts

@@ -2,6 +2,7 @@
 export { loadSettings, updateSettings, setPerm, getModelValue, handleModelSelect, applyCustomModel, onPerCliProviderChange, onCliChange, saveActiveCliSettings, savePerCli, onFlushCliChange, loadFlushAgentSidebar } from './settings-core.js';
 export { setTelegram, setForwardAll, setTelegramMentionOnly, saveTelegramSettings } from './settings-telegram.js';
 export { setDiscord, setDiscordForwardAll, setDiscordAllowBots, setDiscordMentionOnly, saveDiscordSettings } from './settings-discord.js';
+export { setSlack, setSlackForwardAll, setSlackAllowBots, setSlackMentionOnly, setSlackReplyInThread, saveSlackSettings } from './settings-slack.js';
 export { setActiveChannel, loadFallbackOrder, saveFallbackOrder } from './settings-channel.js';
 export { loadMcpServers, syncMcpServers, installMcpGlobal, openMcpModal, initMcpModal } from './settings-mcp.js';
 export { loadCliStatus, scheduleCliStatusRefresh, setCliStatusInterval } from './settings-cli-status.js';

package/public/js/features/transport-status-row.ts

@@ -10,9 +10,10 @@ export type TransportStatus = {
 };
 
 export type ChannelHealth = {
-    activeInbound: 'telegram' | 'discord';
+    activeInbound: 'telegram' | 'discord' | 'slack';
     telegram: TransportStatus;
     discord: TransportStatus;
+    slack: TransportStatus;
 };
 
 function isTransportStatus(value: unknown): value is TransportStatus {
@@ -28,12 +29,22 @@ export function parseChannelHealth(payload: unknown): ChannelHealth | null {
     const channels = (payload as { channels?: unknown }).channels;
     if (!channels || typeof channels !== 'object') return null;
     const row = channels as Record<string, unknown>;
-    if (row['activeInbound'] !== 'telegram' && row['activeInbound'] !== 'discord') return null;
+    // Extract to a local so TypeScript narrows it for the return below; a
+    // repeated property read is not narrowed.
+    const active = row['activeInbound'];
+    if (active !== 'telegram' && active !== 'discord' && active !== 'slack') return null;
     if (!isTransportStatus(row['telegram']) || !isTransportStatus(row['discord'])) return null;
+    // Slack is tolerated as absent: a newer bundle can be served against an
+    // older running server during a rolling update, and rejecting the whole
+    // payload would hide Telegram and Discord health too.
+    const slack = isTransportStatus(row['slack'])
+        ? row['slack']
+        : { configured: false, activeInbound: false, sendCapable: false, reason: 'unavailable' };
     return {
-        activeInbound: row['activeInbound'],
+        activeInbound: active,
         telegram: row['telegram'],
         discord: row['discord'],
+        slack,
     };
 }
 
@@ -71,6 +82,7 @@ export function renderTransportStatusRow(container: HTMLElement, health: Channel
         </h4>
         ${renderTransportBlock('Telegram', health.telegram, true)}
         ${renderTransportBlock('Discord', health.discord, true)}
+        ${renderTransportBlock('Slack', health.slack, true)}
     `;
 }
 

package/public/js/main.ts

@@ -56,6 +56,7 @@ import {
     initCliStatusToggle, initCliStatusPreviewHooks, isCliStatusExpanded, expandCliStatus, isEmbeddedPreviewFrame,
     setTelegram, setForwardAll, setTelegramMentionOnly, saveTelegramSettings,
     setDiscord, setDiscordForwardAll, setDiscordAllowBots, setDiscordMentionOnly, saveDiscordSettings, setActiveChannel,
+    setSlack, setSlackForwardAll, setSlackAllowBots, setSlackMentionOnly, setSlackReplyInThread, saveSlackSettings,
     saveFallbackOrder,
     openTemplateModal, saveTemplateFromModal, closeTemplateModal, templateGoBack, toggleDevMode
 } from './features/settings.js';
@@ -282,6 +283,24 @@ document.getElementById('dcMentionOn')?.addEventListener('click', () => setDisco
 document.getElementById('dcToken')?.addEventListener('change', saveDiscordSettings);
 document.getElementById('dcGuildId')?.addEventListener('change', saveDiscordSettings);
 document.getElementById('dcChannelIds')?.addEventListener('change', saveDiscordSettings);
+
+// Slack
+document.getElementById('chSlack')?.addEventListener('click', () => setActiveChannel('slack'));
+document.getElementById('slOff')?.addEventListener('click', () => setSlack(false));
+document.getElementById('slOn')?.addEventListener('click', () => setSlack(true));
+document.getElementById('slForwardOff')?.addEventListener('click', () => setSlackForwardAll(false));
+document.getElementById('slForwardOn')?.addEventListener('click', () => setSlackForwardAll(true));
+document.getElementById('slAllowBotsOff')?.addEventListener('click', () => setSlackAllowBots(false));
+document.getElementById('slAllowBotsOn')?.addEventListener('click', () => setSlackAllowBots(true));
+document.getElementById('slMentionOff')?.addEventListener('click', () => setSlackMentionOnly(false));
+document.getElementById('slMentionOn')?.addEventListener('click', () => setSlackMentionOnly(true));
+document.getElementById('slThreadOff')?.addEventListener('click', () => setSlackReplyInThread(false));
+document.getElementById('slThreadOn')?.addEventListener('click', () => setSlackReplyInThread(true));
+document.getElementById('slBotToken')?.addEventListener('change', saveSlackSettings);
+document.getElementById('slAppToken')?.addEventListener('change', saveSlackSettings);
+document.getElementById('slTeamId')?.addEventListener('change', saveSlackSettings);
+document.getElementById('slChannelIds')?.addEventListener('change', saveSlackSettings);
+
 document.getElementById('fallbackOrderList')?.addEventListener('change', saveFallbackOrder);
 
 // Codex fast mode toggle

package/public/js/provider-icons.ts

@@ -22,10 +22,11 @@ import kiroMonoSvg from '../assets/providers/kiro.svg?raw';
 
 // Service icons (Discord, Telegram)
 import discordSvg from '../assets/providers/discord.svg?raw';
+import slackSvg from '../assets/providers/slack.svg?raw';
 import telegramSvg from '../assets/providers/telegram.svg?raw';
 import opencodeSvg from '../assets/providers/opencode.svg?raw';
 
-export type ProviderSlug = 'ai-e' | 'claude' | 'openai' | 'gemini' | 'antigravity' | 'grok' | 'copilot' | 'cursor' | 'kiro-code' | 'codex' | 'codex-app' | 'opencode' | 'discord' | 'telegram';
+export type ProviderSlug = 'ai-e' | 'claude' | 'openai' | 'gemini' | 'antigravity' | 'grok' | 'copilot' | 'cursor' | 'kiro-code' | 'codex' | 'codex-app' | 'opencode' | 'discord' | 'telegram' | 'slack';
 
 interface ProviderIcon {
     color: string;
@@ -50,6 +51,7 @@ const PROVIDER_ICONS: Record<ProviderSlug, ProviderIcon> = {
     opencode: { color: opencodeSvg, mono: opencodeSvg,   label: 'OpenCode' },
     discord:  { color: discordSvg,  mono: discordSvg,    label: 'Discord' },
     telegram: { color: telegramSvg, mono: telegramSvg,   label: 'Telegram' },
+    slack:    { color: slackSvg,    mono: slackSvg,      label: 'Slack' },
 };
 
 const PROVIDER_LABEL_ALIASES: Record<string, string> = {
@@ -79,6 +81,7 @@ function resolveProviderSlug(slug: string): ProviderSlug | null {
     if (normalized === 'openai' || normalized.startsWith('gpt') || normalized.startsWith('o1') || normalized.startsWith('o3') || normalized.startsWith('o4')) return 'openai';
     if (normalized === 'discord') return 'discord';
     if (normalized === 'telegram') return 'telegram';
+    if (normalized === 'slack') return 'slack';
     return null;
 }
 

package/public/js/ws.ts

@@ -1088,7 +1088,7 @@ function handleServerEvent(msg: WsMessage): void {
         markRunFinalized(null); // killed run — drop its replayed stream too
         finalizeAgent('');
         setStatus('steering');
-    } else if (msg.type === 'new_message' && (msg.source === 'telegram' || msg.source === 'discord' || msg.source === 'bgtask' || msg.source === 'cli' || msg.source === 'goal' || msg.external === true || msg.fromQueue === true)) {
+    } else if (msg.type === 'new_message' && (msg.source === 'telegram' || msg.source === 'discord' || msg.source === 'slack' || msg.source === 'bgtask' || msg.source === 'cli' || msg.source === 'goal' || msg.external === true || msg.fromQueue === true)) {
         const newMessageRole = msg.role === 'assistant' ? 'agent' : (msg.role || 'user');
         const newMessageContent = msg.content || '';
         const newMessageCli = msg.cli;

package/public/locales/en.json

@@ -504,6 +504,27 @@
     "help.discord.avoid.1": "You expect direct-message delivery",
     "help.discord.related.1": "jaw doctor",
     "help.discord.related.2": "Discord degraded mode",
+    "help.slack.title": "Slack",
+    "help.slack.aria": "Slack help",
+    "help.slack.intro": "Attach a bot to your Slack workspace and drive agents from channels, DMs, and threads.",
+    "help.slack.effect": "Mentions, DMs, and slash commands in allowed conversations reach the agent, and replies come back in-thread.",
+    "help.slack.use.1": "Calling the agent by mention in a team channel",
+    "help.slack.use.2": "Running private work over DM",
+    "help.slack.avoid.1": "When you only have one token — a bot token alone cannot receive events",
+    "help.slack.related.1": "Telegram settings",
+    "help.slack.related.2": "Discord settings",
+    "help.slack.link.portal": "Open the Slack app dashboard",
+    "help.slack.link.docs": "Socket Mode documentation",
+    "help.slack.example.1": "@cli-jaw run the tests for this repo",
+    "help.slack.howTo.1": "Create an app at api.slack.com/apps (a manifest is easiest).",
+    "help.slack.howTo.2": "Enable Socket Mode and generate an app-level token (xapp-) with connections:write.",
+    "help.slack.howTo.3": "Install to the workspace to obtain the bot token (xoxb-).",
+    "help.slack.howTo.4": "Paste each token into its own field below — do not swap them.",
+    "help.slack.howTo.5": "List the conversation IDs the bot may act in. Empty means all are allowed.",
+    "help.slack.howTo.6": "Invite the bot in each channel with /invite @yourbot.",
+    "help.slack.howTo.7": "With Mention Only on, the bot answers channels only when mentioned. DMs always work.",
+    "help.slack.howTo.8": "With Reply in Thread on, answers land in the originating message thread.",
+    "help.slack.howTo.9": "Run cli-jaw doctor to verify the tokens and connection state.",
     "help.fallbackOrder.title": "Fallback",
     "help.fallbackOrder.aria": "Fallback help",
     "help.fallbackOrder.intro": "Sets which CLI is tried when the current one fails or is unavailable.",

package/public/locales/ja.json

@@ -493,6 +493,27 @@
     "help.discord.avoid.1": "DM での配信を期待している場合",
     "help.discord.related.1": "jaw doctor コマンド",
     "help.discord.related.2": "Discord degraded mode の説明",
+    "help.slack.title": "Slack",
+    "help.slack.aria": "Slack ヘルプ",
+    "help.slack.intro": "Attach a bot to your Slack workspace and drive agents from channels, DMs, and threads.",
+    "help.slack.effect": "Mentions, DMs, and slash commands in allowed conversations reach the agent, and replies come back in-thread.",
+    "help.slack.use.1": "Calling the agent by mention in a team channel",
+    "help.slack.use.2": "Running private work over DM",
+    "help.slack.avoid.1": "When you only have one token — a bot token alone cannot receive events",
+    "help.slack.related.1": "Telegram settings",
+    "help.slack.related.2": "Discord settings",
+    "help.slack.link.portal": "Open the Slack app dashboard",
+    "help.slack.link.docs": "Socket Mode documentation",
+    "help.slack.example.1": "@cli-jaw run the tests for this repo",
+    "help.slack.howTo.1": "Create an app at api.slack.com/apps (a manifest is easiest).",
+    "help.slack.howTo.2": "Enable Socket Mode and generate an app-level token (xapp-) with connections:write.",
+    "help.slack.howTo.3": "Install to the workspace to obtain the bot token (xoxb-).",
+    "help.slack.howTo.4": "Paste each token into its own field below — do not swap them.",
+    "help.slack.howTo.5": "List the conversation IDs the bot may act in. Empty means all are allowed.",
+    "help.slack.howTo.6": "Invite the bot in each channel with /invite @yourbot.",
+    "help.slack.howTo.7": "With Mention Only on, the bot answers channels only when mentioned. DMs always work.",
+    "help.slack.howTo.8": "With Reply in Thread on, answers land in the originating message thread.",
+    "help.slack.howTo.9": "Run cli-jaw doctor to verify the tokens and connection state.",
     "help.fallbackOrder.title": "Fallback 設定",
     "help.fallbackOrder.aria": "Fallback ヘルプ",
     "help.fallbackOrder.intro": "現在の CLI が失敗または利用不可になったとき、どの CLI を試すかの順序を設定します。",

package/public/locales/ko.json

@@ -504,6 +504,27 @@
     "help.discord.avoid.1": "DM 전달을 기대하는 경우",
     "help.discord.related.1": "jaw doctor",
     "help.discord.related.2": "Discord degraded mode",
+    "help.slack.title": "Slack",
+    "help.slack.aria": "Slack 도움말",
+    "help.slack.intro": "Slack 워크스페이스에 봇을 붙여 채널·DM·스레드에서 에이전트를 실행합니다.",
+    "help.slack.effect": "허용된 대화에서 멘션·DM·슬래시 커맨드가 에이전트로 전달되고, 답변은 스레드로 돌아옵니다.",
+    "help.slack.use.1": "팀 채널에서 멘션으로 에이전트를 부를 때",
+    "help.slack.use.2": "DM으로 개인 작업을 돌릴 때",
+    "help.slack.avoid.1": "토큰이 하나만 있을 때 — 봇 토큰만으로는 수신이 안 됩니다",
+    "help.slack.related.1": "Telegram 설정",
+    "help.slack.related.2": "Discord 설정",
+    "help.slack.link.portal": "Slack 앱 관리 페이지 열기",
+    "help.slack.link.docs": "Socket Mode 문서",
+    "help.slack.example.1": "@cli-jaw 이 저장소 테스트 돌려줘",
+    "help.slack.howTo.1": "api.slack.com/apps 에서 앱을 만듭니다 (매니페스트 사용 권장).",
+    "help.slack.howTo.2": "Socket Mode를 켜고 connections:write 범위의 app-level 토큰(xapp-)을 발급합니다.",
+    "help.slack.howTo.3": "워크스페이스에 설치해 봇 토큰(xoxb-)을 받습니다.",
+    "help.slack.howTo.4": "두 토큰을 아래 입력란에 각각 붙여넣습니다 — 서로 바꿔 넣지 않도록 주의하세요.",
+    "help.slack.howTo.5": "Channel IDs에 봇이 활동할 대화 ID를 넣습니다. 비우면 전체 허용입니다.",
+    "help.slack.howTo.6": "각 채널에서 /invite @봇이름 으로 봇을 초대합니다.",
+    "help.slack.howTo.7": "Mention Only가 켜져 있으면 채널에서는 멘션할 때만 응답합니다. DM은 항상 응답합니다.",
+    "help.slack.howTo.8": "Reply in Thread가 켜져 있으면 답변이 원 메시지 스레드로 들어갑니다.",
+    "help.slack.howTo.9": "cli-jaw doctor 로 토큰과 연결 상태를 확인합니다.",
     "help.fallbackOrder.title": "Fallback",
     "help.fallbackOrder.aria": "Fallback 도움말",
     "help.fallbackOrder.intro": "현재 CLI가 실패하거나 사용 불가일 때 재시도할 CLI 순서를 정합니다.",

package/public/locales/zh.json

@@ -493,6 +493,27 @@
     "help.discord.avoid.1": "你期待通过私信投递时",
     "help.discord.related.1": "jaw doctor 命令",
     "help.discord.related.2": "Discord 降级模式",
+    "help.slack.title": "Slack",
+    "help.slack.aria": "Slack 帮助",
+    "help.slack.intro": "Attach a bot to your Slack workspace and drive agents from channels, DMs, and threads.",
+    "help.slack.effect": "Mentions, DMs, and slash commands in allowed conversations reach the agent, and replies come back in-thread.",
+    "help.slack.use.1": "Calling the agent by mention in a team channel",
+    "help.slack.use.2": "Running private work over DM",
+    "help.slack.avoid.1": "When you only have one token — a bot token alone cannot receive events",
+    "help.slack.related.1": "Telegram settings",
+    "help.slack.related.2": "Discord settings",
+    "help.slack.link.portal": "Open the Slack app dashboard",
+    "help.slack.link.docs": "Socket Mode documentation",
+    "help.slack.example.1": "@cli-jaw run the tests for this repo",
+    "help.slack.howTo.1": "Create an app at api.slack.com/apps (a manifest is easiest).",
+    "help.slack.howTo.2": "Enable Socket Mode and generate an app-level token (xapp-) with connections:write.",
+    "help.slack.howTo.3": "Install to the workspace to obtain the bot token (xoxb-).",
+    "help.slack.howTo.4": "Paste each token into its own field below — do not swap them.",
+    "help.slack.howTo.5": "List the conversation IDs the bot may act in. Empty means all are allowed.",
+    "help.slack.howTo.6": "Invite the bot in each channel with /invite @yourbot.",
+    "help.slack.howTo.7": "With Mention Only on, the bot answers channels only when mentioned. DMs always work.",
+    "help.slack.howTo.8": "With Reply in Thread on, answers land in the originating message thread.",
+    "help.slack.howTo.9": "Run cli-jaw doctor to verify the tokens and connection state.",
     "help.fallbackOrder.title": "Fallback 设置",
     "help.fallbackOrder.aria": "Fallback 帮助",
     "help.fallbackOrder.intro": "设置当前 CLI 失败或不可用时尝试其他 CLI 的顺序。",

package/public/manager/src/settings/SettingsShell.tsx

@@ -33,6 +33,7 @@ const PAGE_REGISTRY: Record<
     model: lazy(() => import('./pages/ModelProvider')),
     'channels-telegram': lazy(() => import('./pages/ChannelsTelegram')),
     'channels-discord': lazy(() => import('./pages/ChannelsDiscord')),
+    'channels-slack': lazy(() => import('./pages/ChannelsSlack')),
     speech: lazy(() => import('./pages/SpeechKeys')),
     heartbeat: lazy(() => import('./pages/Heartbeat')),
     memory: lazy(() => import('./pages/Memory')),

package/public/manager/src/settings/SettingsSidebar.tsx

@@ -19,6 +19,7 @@ const CATEGORIES: SidebarEntry[] = [
     { id: 'display', label: 'Display', group: 'identity' },
     { id: 'channels-telegram', label: 'Channels — Telegram', group: 'channels' },
     { id: 'channels-discord', label: 'Channels — Discord', group: 'channels' },
+    { id: 'channels-slack', label: 'Channels — Slack', group: 'channels' },
     { id: 'telegram-hub', label: 'Telegram Hub', group: 'channels' },
     { id: 'heartbeat', label: 'Heartbeat & schedules', group: 'automation' },
     { id: 'memory', label: 'Memory', group: 'automation' },

package/public/manager/src/settings/pages/ChannelsSlack.tsx

@@ -0,0 +1,323 @@
+// Channels (Slack) page.
+//
+// Settings keys:
+//   channel                   (shared across telegram + discord + slack pages)
+//   slack.enabled
+//   slack.botToken            (SecretField, masked, never logged)
+//   slack.appToken            (SecretField, masked, never logged)
+//   slack.teamId
+//   slack.channelIds          (string[])
+//   slack.forwardAll
+//   slack.allowBots
+//   slack.mentionOnly
+//   slack.replyInThread
+
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import type { SettingsPageProps, DirtyEntry } from '../types';
+import { ToggleField, SecretField, ChipListField, TextField } from '../fields';
+import {
+    SettingsSection,
+    PageError,
+    PageLoading,
+    PageOffline,
+    usePageSnapshot,
+} from './page-shell';
+import { expandPatch } from './path-utils';
+import { ActiveChannelToggle } from './components/ActiveChannelToggle';
+import type { ActiveChannel } from './components/ActiveChannelToggle';
+import { TransportStatusChips } from './components/TransportStatusChips';
+
+type SlackBlock = {
+    enabled?: boolean;
+    botToken?: string;
+    appToken?: string;
+    teamId?: string;
+    channelIds?: string[];
+    forwardAll?: boolean;
+    allowBots?: boolean;
+    mentionOnly?: boolean;
+    replyInThread?: boolean;
+};
+
+type SlackSnapshot = {
+    channel?: ActiveChannel;
+    slack?: SlackBlock;
+    [key: string]: unknown;
+};
+
+const SLACK_KEYS = [
+    'channel',
+    'slack.enabled',
+    'slack.botToken',
+    'slack.appToken',
+    'slack.teamId',
+    'slack.channelIds',
+    'slack.forwardAll',
+    'slack.allowBots',
+    'slack.mentionOnly',
+    'slack.replyInThread',
+] as const;
+
+/**
+ * Slack conversation ids are prefix-typed, not numeric snowflakes:
+ * C (channel), G (group/MPIM), D (IM) followed by uppercase alphanumerics.
+ * This is the Slack analogue of ChannelsDiscord's isValidSnowflake.
+ */
+export function isValidSlackConversationId(chip: string): boolean {
+    if (!chip) return false;
+    return /^[CGD][A-Z0-9]{6,20}$/.test(chip.trim().toUpperCase());
+}
+
+export default function ChannelsSlack({ port, client, dirty, registerSave }: SettingsPageProps) {
+    const { state, refresh, setData } = usePageSnapshot<SlackSnapshot>(client, '/api/settings');
+
+    const [enabled, setEnabled] = useState(false);
+    const [botToken, setBotToken] = useState('');
+    const [appToken, setAppToken] = useState('');
+    const [teamId, setTeamId] = useState('');
+    const [channelIds, setChannelIds] = useState<string[]>([]);
+    const [forwardAll, setForwardAll] = useState(true);
+    const [allowBots, setAllowBots] = useState(false);
+    const [mentionOnly, setMentionOnly] = useState(true);
+    const [replyInThread, setReplyInThread] = useState(true);
+
+    const applySnapshot = useCallback((sc: SlackBlock) => {
+        setEnabled(Boolean(sc.enabled));
+        setBotToken('');
+        setAppToken('');
+        setTeamId(sc.teamId ?? '');
+        setChannelIds(Array.isArray(sc.channelIds) ? [...sc.channelIds] : []);
+        setForwardAll(sc.forwardAll !== false);
+        setAllowBots(Boolean(sc.allowBots));
+        // These two default TRUE for Slack, so a Boolean() read would show them
+        // off on a fresh install while the backend behaves as on.
+        setMentionOnly(sc.mentionOnly !== false);
+        setReplyInThread(sc.replyInThread !== false);
+    }, []);
+
+    useEffect(() => {
+        if (state.kind !== 'ready') return;
+        applySnapshot(state.data.slack || {});
+    }, [state, applySnapshot]);
+
+    useEffect(() => {
+        return () => {
+            for (const key of SLACK_KEYS) dirty.remove(key);
+        };
+    }, [dirty]);
+
+    const setEntry = useCallback(
+        (key: string, entry: DirtyEntry) => dirty.set(key, entry),
+        [dirty],
+    );
+
+    const original = useMemo<SlackBlock>(() => {
+        if (state.kind !== 'ready') return {};
+        return state.data.slack || {};
+    }, [state]);
+
+    const originalChannel = state.kind === 'ready' ? state.data.channel : undefined;
+
+    const onSave = useCallback(async () => {
+        const bundle = dirty.saveBundle();
+        if (Object.keys(bundle).length === 0) return;
+        const patch = expandPatch(bundle);
+        const updated = await client.put<SlackSnapshot>('/api/settings', patch);
+        const fresh = (updated && typeof updated === 'object' && 'data' in updated
+            ? (updated as { data: SlackSnapshot }).data
+            : updated) as SlackSnapshot;
+        dirty.clear();
+        setData(fresh);
+        applySnapshot(fresh.slack || {});
+        await refresh();
+    }, [client, dirty, refresh, setData, applySnapshot]);
+
+    useEffect(() => {
+        if (!registerSave) return;
+        registerSave(onSave);
+        return () => registerSave(null);
+    }, [registerSave, onSave]);
+
+    if (state.kind === 'loading') return <PageLoading />;
+    if (state.kind === 'offline') return <PageOffline port={port} />;
+    if (state.kind === 'error') return <PageError message={state.message} />;
+
+    const maskOf = (value: string | undefined) =>
+        value ? `••••••••${value.slice(-4)}` : '(empty)';
+    const invalidChannelIds = channelIds.filter((c) => !isValidSlackConversationId(c));
+    const channelIdsError = invalidChannelIds.length > 0
+        ? `Slack conversation IDs only (C…/G…/D…) — invalid: ${invalidChannelIds.join(', ')}`
+        : null;
+    const botTokenError = botToken && !botToken.startsWith('xoxb-')
+        ? 'Bot tokens start with xoxb-.'
+        : null;
+    const appTokenError = appToken && !appToken.startsWith('xapp-')
+        ? 'App-level tokens start with xapp-.'
+        : null;
+    // Surface the outbound-only state on THIS page rather than changing the
+    // shared status chips, which are frozen for cross-channel changes.
+    const outboundOnly = Boolean(original.enabled) && Boolean(original.botToken) && !original.appToken;
+    const slackHint = outboundOnly
+        ? 'Currently OUTBOUND-ONLY: the app-level token (xapp-) is missing, so no inbound Slack events can arrive.'
+        : 'Slack needs TWO tokens: a bot token (xoxb-) for the Web API and an app-level token (xapp-) for Socket Mode.';
+
+    return (
+        <form
+            className="settings-page-form"
+            onSubmit={(event) => {
+                event.preventDefault();
+                void onSave();
+            }}
+        >
+            <SettingsSection
+                title="Channels"
+                hint="Choose which channel receives inbound chat. Outbound send can still work on the other channels when configured."
+            >
+                <ActiveChannelToggle
+                    original={originalChannel}
+                    dirty={dirty}
+                    idPrefix="sl-channel"
+                />
+                <TransportStatusChips client={client} channel="slack" />
+            </SettingsSection>
+
+            <SettingsSection
+                title="Slack"
+                hint={slackHint}
+            >
+                <ToggleField
+                    id="sl-enabled"
+                    label="Slack enabled"
+                    value={enabled}
+                    onChange={(next) => {
+                        setEnabled(next);
+                        setEntry('slack.enabled', {
+                            value: next,
+                            original: Boolean(original.enabled),
+                            valid: true,
+                        });
+                    }}
+                />
+                <SecretField
+                    id="sl-botToken"
+                    label="Bot token"
+                    value={botToken}
+                    placeholder={maskOf(original.botToken)}
+                    error={botTokenError}
+                    onChange={(next) => {
+                        setBotToken(next);
+                        if (next.length === 0) {
+                            dirty.remove('slack.botToken');
+                            return;
+                        }
+                        setEntry('slack.botToken', {
+                            value: next,
+                            original: original.botToken ?? '',
+                            valid: next.startsWith('xoxb-'),
+                        });
+                    }}
+                />
+                <SecretField
+                    id="sl-appToken"
+                    label="App-level token"
+                    value={appToken}
+                    placeholder={maskOf(original.appToken)}
+                    error={appTokenError}
+                    onChange={(next) => {
+                        setAppToken(next);
+                        if (next.length === 0) {
+                            dirty.remove('slack.appToken');
+                            return;
+                        }
+                        setEntry('slack.appToken', {
+                            value: next,
+                            original: original.appToken ?? '',
+                            valid: next.startsWith('xapp-'),
+                        });
+                    }}
+                />
+                <TextField
+                    id="sl-teamId"
+                    label="Team ID"
+                    value={teamId}
+                    placeholder="T01234567 (optional)"
+                    onChange={(next) => {
+                        setTeamId(next);
+                        setEntry('slack.teamId', {
+                            value: next,
+                            original: original.teamId ?? '',
+                            valid: true,
+                        });
+                    }}
+                />
+                <ChipListField
+                    id="sl-channelIds"
+                    label="Channel IDs"
+                    value={channelIds}
+                    placeholder="C01234567"
+                    error={channelIdsError}
+                    onChange={(next) => {
+                        setChannelIds(next);
+                        setEntry('slack.channelIds', {
+                            value: next,
+                            original: original.channelIds ?? [],
+                            valid: next.every(isValidSlackConversationId),
+                        });
+                    }}
+                />
+                <ToggleField
+                    id="sl-mentionOnly"
+                    label="Mention only"
+                    value={mentionOnly}
+                    onChange={(next) => {
+                        setMentionOnly(next);
+                        setEntry('slack.mentionOnly', {
+                            value: next,
+                            original: original.mentionOnly !== false,
+                            valid: true,
+                        });
+                    }}
+                />
+                <ToggleField
+                    id="sl-replyInThread"
+                    label="Reply in thread"
+                    value={replyInThread}
+                    onChange={(next) => {
+                        setReplyInThread(next);
+                        setEntry('slack.replyInThread', {
+                            value: next,
+                            original: original.replyInThread !== false,
+                            valid: true,
+                        });
+                    }}
+                />
+                <ToggleField
+                    id="sl-forwardAll"
+                    label="Forward all"
+                    value={forwardAll}
+                    onChange={(next) => {
+                        setForwardAll(next);
+                        setEntry('slack.forwardAll', {
+                            value: next,
+                            original: original.forwardAll !== false,
+                            valid: true,
+                        });
+                    }}
+                />
+                <ToggleField
+                    id="sl-allowBots"
+                    label="Allow bots"
+                    value={allowBots}
+                    onChange={(next) => {
+                        setAllowBots(next);
+                        setEntry('slack.allowBots', {
+                            value: next,
+                            original: Boolean(original.allowBots),
+                            valid: true,
+                        });
+                    }}
+                />
+            </SettingsSection>
+        </form>
+    );
+}

package/public/manager/src/settings/pages/components/ActiveChannelToggle.tsx

@@ -11,11 +11,12 @@
 import { useCallback, useState } from 'react';
 import type { DirtyStore } from '../../types';
 
-export type ActiveChannel = 'telegram' | 'discord';
+export type ActiveChannel = 'telegram' | 'discord' | 'slack';
 
 const CHANNELS: ReadonlyArray<{ value: ActiveChannel; label: string }> = [
     { value: 'telegram', label: 'Telegram' },
     { value: 'discord', label: 'Discord' },
+    { value: 'slack', label: 'Slack' },
 ];
 
 type Props = {