@ai-devkit/channel-connector 0.10.1 → 0.13.0

package/README.md

@@ -2,7 +2,7 @@
 
 Bridge AI DevKit agent sessions to external messaging channels.
 
-This package powers the `ai-devkit channel` commands. Use it when you need the lower-level connector layer that routes messages between running AI coding agents and channels such as Telegram.
+This package powers the `ai-devkit channel` commands. Use it when you need the lower-level connector layer that routes messages between running AI coding agents and channels such as Telegram and private Slack DMs.
 
 ## What It Provides
 
@@ -17,11 +17,14 @@ Most users should use the CLI:
 
 ```bash
 ai-devkit channel connect telegram
+ai-devkit channel connect slack --name work-slack
 ai-devkit channel start --agent <agent-name>
 ```
 
 Use this package directly only when building custom channel integrations or extending AI DevKit's remote-control surface.
 
+Slack uses the official `@slack/socket-mode` and `@slack/web-api` clients. The current proof of concept is a user-owned, single-workspace, DM-only Socket Mode app without Slack-user authorization. Use it only in a disposable/private workspace with a non-sensitive agent session. Public channels, OAuth distribution, files, and multi-workspace routing are not supported.
+
 ## Documentation
 
 Full guides and workflow examples: **[ai-devkit.com/docs](https://ai-devkit.com/docs/)**

package/dist/ConfigStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigStore.d.ts","sourceRoot":"","sources":["../src/ConfigStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK9D;;;;GAIG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,CAAC,EAAE,MAAM;IAI/B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IASzC;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnE;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;YAKnD,WAAW;CAK5B"}
+{"version":3,"file":"ConfigStore.d.ts","sourceRoot":"","sources":["../src/ConfigStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK9D;;;;GAIG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,CAAC,EAAE,MAAM;IAI/B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IASzC;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnE;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;YAKnD,WAAW;CAM5B"}

package/dist/ConfigStore.js

@@ -55,6 +55,7 @@ const DEFAULT_CONFIG = {
         fs.writeFileSync(this.configPath, JSON.stringify(config, null, 2), {
             mode: 0o600
         });
+        fs.chmodSync(this.configPath, 0o600);
     }
 }
 

package/dist/ConfigStore.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ConfigStore.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport type { ChannelConfig, ChannelEntry } from './types.js';\n\nconst DEFAULT_CONFIG_PATH = path.join(os.homedir(), '.ai-devkit', 'channels.json');\nconst DEFAULT_CONFIG: ChannelConfig = { channels: {} };\n\n/**\n * Persists channel configurations to disk.\n * Default location: ~/.ai-devkit/channels.json\n * File permissions are set to 0600 to protect tokens.\n */\nexport class ConfigStore {\n    private configPath: string;\n\n    constructor(configPath?: string) {\n        this.configPath = configPath ?? DEFAULT_CONFIG_PATH;\n    }\n\n    /**\n     * Read the full config. Returns default empty config if file is missing or corrupt.\n     */\n    async getConfig(): Promise<ChannelConfig> {\n        try {\n            const raw = fs.readFileSync(this.configPath, 'utf-8');\n            return JSON.parse(raw) as ChannelConfig;\n        } catch {\n            return { ...DEFAULT_CONFIG, channels: {} };\n        }\n    }\n\n    /**\n     * Save a channel entry. Creates the file and parent directory if needed.\n     */\n    async saveChannel(name: string, entry: ChannelEntry): Promise<void> {\n        const config = await this.getConfig();\n        config.channels[name] = entry;\n        await this.writeConfig(config);\n    }\n\n    /**\n     * Remove a channel entry by name.\n     */\n    async removeChannel(name: string): Promise<void> {\n        const config = await this.getConfig();\n        delete config.channels[name];\n        await this.writeConfig(config);\n    }\n\n    /**\n     * Get a single channel entry by name.\n     */\n    async getChannel(name: string): Promise<ChannelEntry | undefined> {\n        const config = await this.getConfig();\n        return config.channels[name];\n    }\n\n    private async writeConfig(config: ChannelConfig): Promise<void> {\n        const dir = path.dirname(this.configPath);\n        fs.mkdirSync(dir, { recursive: true });\n        fs.writeFileSync(this.configPath, JSON.stringify(config, null, 2), { mode: 0o600 });\n    }\n}\n"],"names":["fs","path","os","DEFAULT_CONFIG_PATH","join","homedir","DEFAULT_CONFIG","channels","ConfigStore","configPath","getConfig","raw","readFileSync","JSON","parse","saveChannel","name","entry","config","writeConfig","removeChannel","getChannel","dir","dirname","mkdirSync","recursive","writeFileSync","stringify","mode"],"mappings":"AAAA,YAAYA,QAAQ,KAAK;AACzB,YAAYC,UAAU,OAAO;AAC7B,YAAYC,QAAQ,KAAK;AAGzB,MAAMC,sBAAsBF,KAAKG,IAAI,CAACF,GAAGG,OAAO,IAAI,cAAc;AAClE,MAAMC,iBAAgC;IAAEC,UAAU,CAAC;AAAE;AAErD;;;;CAIC,GACD,OAAO,MAAMC;IACDC,WAAmB;IAE3B,YAAYA,UAAmB,CAAE;QAC7B,IAAI,CAACA,UAAU,GAAGA,cAAcN;IACpC;IAEA;;KAEC,GACD,MAAMO,YAAoC;QACtC,IAAI;YACA,MAAMC,MAAMX,GAAGY,YAAY,CAAC,IAAI,CAACH,UAAU,EAAE;YAC7C,OAAOI,KAAKC,KAAK,CAACH;QACtB,EAAE,OAAM;YACJ,OAAO;gBAAE,GAAGL,cAAc;gBAAEC,UAAU,CAAC;YAAE;QAC7C;IACJ;IAEA;;KAEC,GACD,MAAMQ,YAAYC,IAAY,EAAEC,KAAmB,EAAiB;QAChE,MAAMC,SAAS,MAAM,IAAI,CAACR,SAAS;QACnCQ,OAAOX,QAAQ,CAACS,KAAK,GAAGC;QACxB,MAAM,IAAI,CAACE,WAAW,CAACD;IAC3B;IAEA;;KAEC,GACD,MAAME,cAAcJ,IAAY,EAAiB;QAC7C,MAAME,SAAS,MAAM,IAAI,CAACR,SAAS;QACnC,OAAOQ,OAAOX,QAAQ,CAACS,KAAK;QAC5B,MAAM,IAAI,CAACG,WAAW,CAACD;IAC3B;IAEA;;KAEC,GACD,MAAMG,WAAWL,IAAY,EAAqC;QAC9D,MAAME,SAAS,MAAM,IAAI,CAACR,SAAS;QACnC,OAAOQ,OAAOX,QAAQ,CAACS,KAAK;IAChC;IAEA,MAAcG,YAAYD,MAAqB,EAAiB;QAC5D,MAAMI,MAAMrB,KAAKsB,OAAO,CAAC,IAAI,CAACd,UAAU;QACxCT,GAAGwB,SAAS,CAACF,KAAK;YAAEG,WAAW;QAAK;QACpCzB,GAAG0B,aAAa,CAAC,IAAI,CAACjB,UAAU,EAAEI,KAAKc,SAAS,CAACT,QAAQ,MAAM,IAAI;YAAEU,MAAM;QAAM;IACrF;AACJ"}
+{"version":3,"sources":["../src/ConfigStore.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport type { ChannelConfig, ChannelEntry } from './types.js';\n\nconst DEFAULT_CONFIG_PATH = path.join(os.homedir(), '.ai-devkit', 'channels.json');\nconst DEFAULT_CONFIG: ChannelConfig = { channels: {} };\n\n/**\n * Persists channel configurations to disk.\n * Default location: ~/.ai-devkit/channels.json\n * File permissions are set to 0600 to protect tokens.\n */\nexport class ConfigStore {\n    private configPath: string;\n\n    constructor(configPath?: string) {\n        this.configPath = configPath ?? DEFAULT_CONFIG_PATH;\n    }\n\n    /**\n     * Read the full config. Returns default empty config if file is missing or corrupt.\n     */\n    async getConfig(): Promise<ChannelConfig> {\n        try {\n            const raw = fs.readFileSync(this.configPath, 'utf-8');\n            return JSON.parse(raw) as ChannelConfig;\n        } catch {\n            return { ...DEFAULT_CONFIG, channels: {} };\n        }\n    }\n\n    /**\n     * Save a channel entry. Creates the file and parent directory if needed.\n     */\n    async saveChannel(name: string, entry: ChannelEntry): Promise<void> {\n        const config = await this.getConfig();\n        config.channels[name] = entry;\n        await this.writeConfig(config);\n    }\n\n    /**\n     * Remove a channel entry by name.\n     */\n    async removeChannel(name: string): Promise<void> {\n        const config = await this.getConfig();\n        delete config.channels[name];\n        await this.writeConfig(config);\n    }\n\n    /**\n     * Get a single channel entry by name.\n     */\n    async getChannel(name: string): Promise<ChannelEntry | undefined> {\n        const config = await this.getConfig();\n        return config.channels[name];\n    }\n\n    private async writeConfig(config: ChannelConfig): Promise<void> {\n        const dir = path.dirname(this.configPath);\n        fs.mkdirSync(dir, { recursive: true });\n        fs.writeFileSync(this.configPath, JSON.stringify(config, null, 2), { mode: 0o600 });\n        fs.chmodSync(this.configPath, 0o600);\n    }\n}\n"],"names":["fs","path","os","DEFAULT_CONFIG_PATH","join","homedir","DEFAULT_CONFIG","channels","ConfigStore","configPath","getConfig","raw","readFileSync","JSON","parse","saveChannel","name","entry","config","writeConfig","removeChannel","getChannel","dir","dirname","mkdirSync","recursive","writeFileSync","stringify","mode","chmodSync"],"mappings":"AAAA,YAAYA,QAAQ,KAAK;AACzB,YAAYC,UAAU,OAAO;AAC7B,YAAYC,QAAQ,KAAK;AAGzB,MAAMC,sBAAsBF,KAAKG,IAAI,CAACF,GAAGG,OAAO,IAAI,cAAc;AAClE,MAAMC,iBAAgC;IAAEC,UAAU,CAAC;AAAE;AAErD;;;;CAIC,GACD,OAAO,MAAMC;IACDC,WAAmB;IAE3B,YAAYA,UAAmB,CAAE;QAC7B,IAAI,CAACA,UAAU,GAAGA,cAAcN;IACpC;IAEA;;KAEC,GACD,MAAMO,YAAoC;QACtC,IAAI;YACA,MAAMC,MAAMX,GAAGY,YAAY,CAAC,IAAI,CAACH,UAAU,EAAE;YAC7C,OAAOI,KAAKC,KAAK,CAACH;QACtB,EAAE,OAAM;YACJ,OAAO;gBAAE,GAAGL,cAAc;gBAAEC,UAAU,CAAC;YAAE;QAC7C;IACJ;IAEA;;KAEC,GACD,MAAMQ,YAAYC,IAAY,EAAEC,KAAmB,EAAiB;QAChE,MAAMC,SAAS,MAAM,IAAI,CAACR,SAAS;QACnCQ,OAAOX,QAAQ,CAACS,KAAK,GAAGC;QACxB,MAAM,IAAI,CAACE,WAAW,CAACD;IAC3B;IAEA;;KAEC,GACD,MAAME,cAAcJ,IAAY,EAAiB;QAC7C,MAAME,SAAS,MAAM,IAAI,CAACR,SAAS;QACnC,OAAOQ,OAAOX,QAAQ,CAACS,KAAK;QAC5B,MAAM,IAAI,CAACG,WAAW,CAACD;IAC3B;IAEA;;KAEC,GACD,MAAMG,WAAWL,IAAY,EAAqC;QAC9D,MAAME,SAAS,MAAM,IAAI,CAACR,SAAS;QACnC,OAAOQ,OAAOX,QAAQ,CAACS,KAAK;IAChC;IAEA,MAAcG,YAAYD,MAAqB,EAAiB;QAC5D,MAAMI,MAAMrB,KAAKsB,OAAO,CAAC,IAAI,CAACd,UAAU;QACxCT,GAAGwB,SAAS,CAACF,KAAK;YAAEG,WAAW;QAAK;QACpCzB,GAAG0B,aAAa,CAAC,IAAI,CAACjB,UAAU,EAAEI,KAAKc,SAAS,CAACT,QAAQ,MAAM,IAAI;YAAEU,MAAM;QAAM;QACjF5B,GAAG6B,SAAS,CAAC,IAAI,CAACpB,UAAU,EAAE;IAClC;AACJ"}

package/dist/__tests__/ChannelManager.test.js

@@ -4,7 +4,9 @@ function createMockAdapter(type) {
         type,
         start: vi.fn().mockResolvedValue(undefined),
         stop: vi.fn().mockResolvedValue(undefined),
-        sendMessage: vi.fn().mockResolvedValue(undefined),
+        sendMessage: vi.fn().mockResolvedValue({
+            messageId: '1'
+        }),
         onMessage: vi.fn(),
         isHealthy: vi.fn().mockResolvedValue(true)
     };

package/dist/__tests__/ChannelManager.test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/__tests__/ChannelManager.test.ts"],"sourcesContent":["import type { Mocked } from 'vitest';\nimport { ChannelManager } from '../ChannelManager.js';\nimport type { ChannelAdapter } from '../adapters/ChannelAdapter.js';\n\nfunction createMockAdapter(type: string): Mocked<ChannelAdapter> {\n    return {\n        type,\n        start: vi.fn().mockResolvedValue(undefined),\n        stop: vi.fn().mockResolvedValue(undefined),\n        sendMessage: vi.fn().mockResolvedValue(undefined),\n        onMessage: vi.fn(),\n        isHealthy: vi.fn().mockResolvedValue(true),\n    };\n}\n\ndescribe('ChannelManager', () => {\n    let manager: ChannelManager;\n\n    beforeEach(() => {\n        manager = new ChannelManager();\n    });\n\n    describe('registerAdapter', () => {\n        it('should register an adapter', () => {\n            const adapter = createMockAdapter('telegram');\n            manager.registerAdapter(adapter);\n            expect(manager.getAdapter('telegram')).toBe(adapter);\n        });\n\n        it('should throw on duplicate adapter type', () => {\n            const adapter1 = createMockAdapter('telegram');\n            const adapter2 = createMockAdapter('telegram');\n            manager.registerAdapter(adapter1);\n            expect(() => manager.registerAdapter(adapter2)).toThrow(\n                'Adapter for type \"telegram\" is already registered'\n            );\n        });\n    });\n\n    describe('getAdapter', () => {\n        it('should return undefined for unregistered type', () => {\n            expect(manager.getAdapter('slack')).toBeUndefined();\n        });\n\n        it('should return the registered adapter', () => {\n            const adapter = createMockAdapter('telegram');\n            manager.registerAdapter(adapter);\n            expect(manager.getAdapter('telegram')).toBe(adapter);\n        });\n    });\n\n    describe('startAll', () => {\n        it('should call start() on all registered adapters', async () => {\n            const telegram = createMockAdapter('telegram');\n            const slack = createMockAdapter('slack');\n            manager.registerAdapter(telegram);\n            manager.registerAdapter(slack);\n\n            await manager.startAll();\n\n            expect(telegram.start).toHaveBeenCalledTimes(1);\n            expect(slack.start).toHaveBeenCalledTimes(1);\n        });\n\n        it('should work with no adapters', async () => {\n            await expect(manager.startAll()).resolves.toBeUndefined();\n        });\n    });\n\n    describe('stopAll', () => {\n        it('should call stop() on all registered adapters', async () => {\n            const telegram = createMockAdapter('telegram');\n            const slack = createMockAdapter('slack');\n            manager.registerAdapter(telegram);\n            manager.registerAdapter(slack);\n\n            await manager.stopAll();\n\n            expect(telegram.stop).toHaveBeenCalledTimes(1);\n            expect(slack.stop).toHaveBeenCalledTimes(1);\n        });\n\n        it('should work with no adapters', async () => {\n            await expect(manager.stopAll()).resolves.toBeUndefined();\n        });\n    });\n});\n"],"names":["ChannelManager","createMockAdapter","type","start","vi","fn","mockResolvedValue","undefined","stop","sendMessage","onMessage","isHealthy","describe","manager","beforeEach","it","adapter","registerAdapter","expect","getAdapter","toBe","adapter1","adapter2","toThrow","toBeUndefined","telegram","slack","startAll","toHaveBeenCalledTimes","resolves","stopAll"],"mappings":"AACA,SAASA,cAAc,QAAQ,uBAAuB;AAGtD,SAASC,kBAAkBC,IAAY;IACnC,OAAO;QACHA;QACAC,OAAOC,GAAGC,EAAE,GAAGC,iBAAiB,CAACC;QACjCC,MAAMJ,GAAGC,EAAE,GAAGC,iBAAiB,CAACC;QAChCE,aAAaL,GAAGC,EAAE,GAAGC,iBAAiB,CAACC;QACvCG,WAAWN,GAAGC,EAAE;QAChBM,WAAWP,GAAGC,EAAE,GAAGC,iBAAiB,CAAC;IACzC;AACJ;AAEAM,SAAS,kBAAkB;IACvB,IAAIC;IAEJC,WAAW;QACPD,UAAU,IAAIb;IAClB;IAEAY,SAAS,mBAAmB;QACxBG,GAAG,8BAA8B;YAC7B,MAAMC,UAAUf,kBAAkB;YAClCY,QAAQI,eAAe,CAACD;YACxBE,OAAOL,QAAQM,UAAU,CAAC,aAAaC,IAAI,CAACJ;QAChD;QAEAD,GAAG,0CAA0C;YACzC,MAAMM,WAAWpB,kBAAkB;YACnC,MAAMqB,WAAWrB,kBAAkB;YACnCY,QAAQI,eAAe,CAACI;YACxBH,OAAO,IAAML,QAAQI,eAAe,CAACK,WAAWC,OAAO,CACnD;QAER;IACJ;IAEAX,SAAS,cAAc;QACnBG,GAAG,iDAAiD;YAChDG,OAAOL,QAAQM,UAAU,CAAC,UAAUK,aAAa;QACrD;QAEAT,GAAG,wCAAwC;YACvC,MAAMC,UAAUf,kBAAkB;YAClCY,QAAQI,eAAe,CAACD;YACxBE,OAAOL,QAAQM,UAAU,CAAC,aAAaC,IAAI,CAACJ;QAChD;IACJ;IAEAJ,SAAS,YAAY;QACjBG,GAAG,kDAAkD;YACjD,MAAMU,WAAWxB,kBAAkB;YACnC,MAAMyB,QAAQzB,kBAAkB;YAChCY,QAAQI,eAAe,CAACQ;YACxBZ,QAAQI,eAAe,CAACS;YAExB,MAAMb,QAAQc,QAAQ;YAEtBT,OAAOO,SAAStB,KAAK,EAAEyB,qBAAqB,CAAC;YAC7CV,OAAOQ,MAAMvB,KAAK,EAAEyB,qBAAqB,CAAC;QAC9C;QAEAb,GAAG,gCAAgC;YAC/B,MAAMG,OAAOL,QAAQc,QAAQ,IAAIE,QAAQ,CAACL,aAAa;QAC3D;IACJ;IAEAZ,SAAS,WAAW;QAChBG,GAAG,iDAAiD;YAChD,MAAMU,WAAWxB,kBAAkB;YACnC,MAAMyB,QAAQzB,kBAAkB;YAChCY,QAAQI,eAAe,CAACQ;YACxBZ,QAAQI,eAAe,CAACS;YAExB,MAAMb,QAAQiB,OAAO;YAErBZ,OAAOO,SAASjB,IAAI,EAAEoB,qBAAqB,CAAC;YAC5CV,OAAOQ,MAAMlB,IAAI,EAAEoB,qBAAqB,CAAC;QAC7C;QAEAb,GAAG,gCAAgC;YAC/B,MAAMG,OAAOL,QAAQiB,OAAO,IAAID,QAAQ,CAACL,aAAa;QAC1D;IACJ;AACJ"}
+{"version":3,"sources":["../../src/__tests__/ChannelManager.test.ts"],"sourcesContent":["import type { Mocked } from 'vitest';\nimport { ChannelManager } from '../ChannelManager.js';\nimport type { ChannelAdapter } from '../adapters/ChannelAdapter.js';\n\nfunction createMockAdapter(type: string): Mocked<ChannelAdapter> {\n    return {\n        type,\n        start: vi.fn().mockResolvedValue(undefined),\n        stop: vi.fn().mockResolvedValue(undefined),\n        sendMessage: vi.fn().mockResolvedValue({ messageId: '1' }),\n        onMessage: vi.fn(),\n        isHealthy: vi.fn().mockResolvedValue(true),\n    };\n}\n\ndescribe('ChannelManager', () => {\n    let manager: ChannelManager;\n\n    beforeEach(() => {\n        manager = new ChannelManager();\n    });\n\n    describe('registerAdapter', () => {\n        it('should register an adapter', () => {\n            const adapter = createMockAdapter('telegram');\n            manager.registerAdapter(adapter);\n            expect(manager.getAdapter('telegram')).toBe(adapter);\n        });\n\n        it('should throw on duplicate adapter type', () => {\n            const adapter1 = createMockAdapter('telegram');\n            const adapter2 = createMockAdapter('telegram');\n            manager.registerAdapter(adapter1);\n            expect(() => manager.registerAdapter(adapter2)).toThrow(\n                'Adapter for type \"telegram\" is already registered'\n            );\n        });\n    });\n\n    describe('getAdapter', () => {\n        it('should return undefined for unregistered type', () => {\n            expect(manager.getAdapter('slack')).toBeUndefined();\n        });\n\n        it('should return the registered adapter', () => {\n            const adapter = createMockAdapter('telegram');\n            manager.registerAdapter(adapter);\n            expect(manager.getAdapter('telegram')).toBe(adapter);\n        });\n    });\n\n    describe('startAll', () => {\n        it('should call start() on all registered adapters', async () => {\n            const telegram = createMockAdapter('telegram');\n            const slack = createMockAdapter('slack');\n            manager.registerAdapter(telegram);\n            manager.registerAdapter(slack);\n\n            await manager.startAll();\n\n            expect(telegram.start).toHaveBeenCalledTimes(1);\n            expect(slack.start).toHaveBeenCalledTimes(1);\n        });\n\n        it('should work with no adapters', async () => {\n            await expect(manager.startAll()).resolves.toBeUndefined();\n        });\n    });\n\n    describe('stopAll', () => {\n        it('should call stop() on all registered adapters', async () => {\n            const telegram = createMockAdapter('telegram');\n            const slack = createMockAdapter('slack');\n            manager.registerAdapter(telegram);\n            manager.registerAdapter(slack);\n\n            await manager.stopAll();\n\n            expect(telegram.stop).toHaveBeenCalledTimes(1);\n            expect(slack.stop).toHaveBeenCalledTimes(1);\n        });\n\n        it('should work with no adapters', async () => {\n            await expect(manager.stopAll()).resolves.toBeUndefined();\n        });\n    });\n});\n"],"names":["ChannelManager","createMockAdapter","type","start","vi","fn","mockResolvedValue","undefined","stop","sendMessage","messageId","onMessage","isHealthy","describe","manager","beforeEach","it","adapter","registerAdapter","expect","getAdapter","toBe","adapter1","adapter2","toThrow","toBeUndefined","telegram","slack","startAll","toHaveBeenCalledTimes","resolves","stopAll"],"mappings":"AACA,SAASA,cAAc,QAAQ,uBAAuB;AAGtD,SAASC,kBAAkBC,IAAY;IACnC,OAAO;QACHA;QACAC,OAAOC,GAAGC,EAAE,GAAGC,iBAAiB,CAACC;QACjCC,MAAMJ,GAAGC,EAAE,GAAGC,iBAAiB,CAACC;QAChCE,aAAaL,GAAGC,EAAE,GAAGC,iBAAiB,CAAC;YAAEI,WAAW;QAAI;QACxDC,WAAWP,GAAGC,EAAE;QAChBO,WAAWR,GAAGC,EAAE,GAAGC,iBAAiB,CAAC;IACzC;AACJ;AAEAO,SAAS,kBAAkB;IACvB,IAAIC;IAEJC,WAAW;QACPD,UAAU,IAAId;IAClB;IAEAa,SAAS,mBAAmB;QACxBG,GAAG,8BAA8B;YAC7B,MAAMC,UAAUhB,kBAAkB;YAClCa,QAAQI,eAAe,CAACD;YACxBE,OAAOL,QAAQM,UAAU,CAAC,aAAaC,IAAI,CAACJ;QAChD;QAEAD,GAAG,0CAA0C;YACzC,MAAMM,WAAWrB,kBAAkB;YACnC,MAAMsB,WAAWtB,kBAAkB;YACnCa,QAAQI,eAAe,CAACI;YACxBH,OAAO,IAAML,QAAQI,eAAe,CAACK,WAAWC,OAAO,CACnD;QAER;IACJ;IAEAX,SAAS,cAAc;QACnBG,GAAG,iDAAiD;YAChDG,OAAOL,QAAQM,UAAU,CAAC,UAAUK,aAAa;QACrD;QAEAT,GAAG,wCAAwC;YACvC,MAAMC,UAAUhB,kBAAkB;YAClCa,QAAQI,eAAe,CAACD;YACxBE,OAAOL,QAAQM,UAAU,CAAC,aAAaC,IAAI,CAACJ;QAChD;IACJ;IAEAJ,SAAS,YAAY;QACjBG,GAAG,kDAAkD;YACjD,MAAMU,WAAWzB,kBAAkB;YACnC,MAAM0B,QAAQ1B,kBAAkB;YAChCa,QAAQI,eAAe,CAACQ;YACxBZ,QAAQI,eAAe,CAACS;YAExB,MAAMb,QAAQc,QAAQ;YAEtBT,OAAOO,SAASvB,KAAK,EAAE0B,qBAAqB,CAAC;YAC7CV,OAAOQ,MAAMxB,KAAK,EAAE0B,qBAAqB,CAAC;QAC9C;QAEAb,GAAG,gCAAgC;YAC/B,MAAMG,OAAOL,QAAQc,QAAQ,IAAIE,QAAQ,CAACL,aAAa;QAC3D;IACJ;IAEAZ,SAAS,WAAW;QAChBG,GAAG,iDAAiD;YAChD,MAAMU,WAAWzB,kBAAkB;YACnC,MAAM0B,QAAQ1B,kBAAkB;YAChCa,QAAQI,eAAe,CAACQ;YACxBZ,QAAQI,eAAe,CAACS;YAExB,MAAMb,QAAQiB,OAAO;YAErBZ,OAAOO,SAASlB,IAAI,EAAEqB,qBAAqB,CAAC;YAC5CV,OAAOQ,MAAMnB,IAAI,EAAEqB,qBAAqB,CAAC;QAC7C;QAEAb,GAAG,gCAAgC;YAC/B,MAAMG,OAAOL,QAAQiB,OAAO,IAAID,QAAQ,CAACL,aAAa;QAC1D;IACJ;AACJ"}

package/dist/__tests__/ConfigStore.test.js

@@ -2,6 +2,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
 import { ConfigStore } from '../ConfigStore.js';
+import { isSlackEntry } from '../types.js';
 describe('ConfigStore', ()=>{
     let tmpDir;
     let configPath;
@@ -26,6 +27,21 @@ describe('ConfigStore', ()=>{
             botUsername: 'test_bot'
         }
     };
+    const slackEntry = {
+        type: 'slack',
+        enabled: true,
+        createdAt: '2026-08-06T00:00:00Z',
+        config: {
+            appToken: 'xapp-fake',
+            botToken: 'xoxb-fake',
+            appId: 'A123',
+            botUserId: 'U-BOT',
+            workspaceId: 'T123',
+            workspaceName: 'Sandbox',
+            transport: 'socket-mode',
+            audience: 'dm'
+        }
+    };
     describe('constructor', ()=>{
         it('should use default path when no configPath provided', async ()=>{
             const defaultStore = new ConfigStore();
@@ -35,6 +51,11 @@ describe('ConfigStore', ()=>{
         });
     });
     describe('getConfig', ()=>{
+        it('narrows provider configuration from the channel type', ()=>{
+            expect(isSlackEntry(slackEntry)).toBe(true);
+            if (!isSlackEntry(slackEntry)) throw new Error('expected Slack entry');
+            expect(slackEntry.config.workspaceId).toBe('T123');
+        });
         it('should return default empty config when file does not exist', async ()=>{
             const config = await store.getConfig();
             expect(config).toEqual({
@@ -77,17 +98,25 @@ describe('ConfigStore', ()=>{
             const mode = (stats.mode & 0o777).toString(8);
             expect(mode).toBe('600');
         });
+        it('should repair permissive permissions on an existing config file', async ()=>{
+            fs.writeFileSync(configPath, JSON.stringify({
+                channels: {}
+            }), {
+                mode: 0o644
+            });
+            fs.chmodSync(configPath, 0o644);
+            await store.saveChannel('slack', slackEntry);
+            expect(fs.statSync(configPath).mode & 0o777).toBe(0o600);
+        });
         it('should preserve existing channels when adding a new one', async ()=>{
             await store.saveChannel('telegram', sampleEntry);
-            await store.saveChannel('slack', {
-                ...sampleEntry,
-                type: 'slack'
-            });
+            await store.saveChannel('slack', slackEntry);
             const config = await store.getConfig();
             expect(Object.keys(config.channels)).toEqual([
                 'telegram',
                 'slack'
             ]);
+            expect(config.channels.slack).toEqual(slackEntry);
         });
         it('should preserve separate Telegram configs by channel name', async ()=>{
             await store.saveChannel('personal', {

package/dist/__tests__/ConfigStore.test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/__tests__/ConfigStore.test.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport { ConfigStore } from '../ConfigStore.js';\nimport type { ChannelEntry } from '../types.js';\n\ndescribe('ConfigStore', () => {\n    let tmpDir: string;\n    let configPath: string;\n    let store: ConfigStore;\n\n    beforeEach(() => {\n        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'channel-connector-test-'));\n        configPath = path.join(tmpDir, 'channels.json');\n        store = new ConfigStore(configPath);\n    });\n\n    afterEach(() => {\n        fs.rmSync(tmpDir, { recursive: true, force: true });\n    });\n\n    const sampleEntry: ChannelEntry = {\n        type: 'telegram',\n        enabled: true,\n        createdAt: '2026-04-11T00:00:00Z',\n        config: {\n            botToken: 'test-token-123',\n            botUsername: 'test_bot',\n        },\n    };\n\n    describe('constructor', () => {\n        it('should use default path when no configPath provided', async () => {\n            const defaultStore = new ConfigStore();\n            // Should not throw — just uses default path\n            const config = await defaultStore.getConfig();\n            expect(config).toBeDefined();\n        });\n    });\n\n    describe('getConfig', () => {\n        it('should return default empty config when file does not exist', async () => {\n            const config = await store.getConfig();\n            expect(config).toEqual({ channels: {} });\n        });\n\n        it('should return parsed config when file exists', async () => {\n            fs.writeFileSync(configPath, JSON.stringify({\n                channels: { telegram: sampleEntry }\n            }));\n\n            const config = await store.getConfig();\n            expect(config.channels.telegram).toEqual(sampleEntry);\n        });\n\n        it('should handle corrupted JSON gracefully', async () => {\n            fs.writeFileSync(configPath, 'not valid json{{{');\n\n            const config = await store.getConfig();\n            expect(config).toEqual({ channels: {} });\n        });\n    });\n\n    describe('saveChannel', () => {\n        it('should create config file with channel entry', async () => {\n            await store.saveChannel('telegram', sampleEntry);\n\n            const raw = fs.readFileSync(configPath, 'utf-8');\n            const config = JSON.parse(raw);\n            expect(config.channels.telegram).toEqual(sampleEntry);\n        });\n\n        it('should create parent directory if missing', async () => {\n            const nestedPath = path.join(tmpDir, 'nested', 'dir', 'channels.json');\n            const nestedStore = new ConfigStore(nestedPath);\n\n            await nestedStore.saveChannel('telegram', sampleEntry);\n\n            expect(fs.existsSync(nestedPath)).toBe(true);\n        });\n\n        it('should set file permissions to 0600', async () => {\n            await store.saveChannel('telegram', sampleEntry);\n\n            const stats = fs.statSync(configPath);\n            const mode = (stats.mode & 0o777).toString(8);\n            expect(mode).toBe('600');\n        });\n\n        it('should preserve existing channels when adding a new one', async () => {\n            await store.saveChannel('telegram', sampleEntry);\n            await store.saveChannel('slack', { ...sampleEntry, type: 'slack' });\n\n            const config = await store.getConfig();\n            expect(Object.keys(config.channels)).toEqual(['telegram', 'slack']);\n        });\n\n        it('should preserve separate Telegram configs by channel name', async () => {\n            await store.saveChannel('personal', {\n                ...sampleEntry,\n                config: {\n                    botToken: 'personal-token',\n                    botUsername: 'personal_bot',\n                    authorizedChatId: 111,\n                },\n            });\n            await store.saveChannel('work', {\n                ...sampleEntry,\n                config: {\n                    botToken: 'work-token',\n                    botUsername: 'work_bot',\n                    authorizedChatId: 222,\n                },\n            });\n\n            const config = await store.getConfig();\n            expect(config.channels.personal.config).toEqual({\n                botToken: 'personal-token',\n                botUsername: 'personal_bot',\n                authorizedChatId: 111,\n            });\n            expect(config.channels.work.config).toEqual({\n                botToken: 'work-token',\n                botUsername: 'work_bot',\n                authorizedChatId: 222,\n            });\n        });\n    });\n\n    describe('removeChannel', () => {\n        it('should remove a channel entry', async () => {\n            await store.saveChannel('telegram', sampleEntry);\n            await store.removeChannel('telegram');\n\n            const config = await store.getConfig();\n            expect(config.channels.telegram).toBeUndefined();\n        });\n\n        it('should not throw when removing non-existent channel', async () => {\n            await expect(store.removeChannel('nonexistent')).resolves.toBeUndefined();\n        });\n    });\n\n    describe('getChannel', () => {\n        it('should return the channel entry', async () => {\n            await store.saveChannel('telegram', sampleEntry);\n\n            const entry = await store.getChannel('telegram');\n            expect(entry).toEqual(sampleEntry);\n        });\n\n        it('should return undefined for non-existent channel', async () => {\n            const entry = await store.getChannel('slack');\n            expect(entry).toBeUndefined();\n        });\n    });\n});\n"],"names":["fs","path","os","ConfigStore","describe","tmpDir","configPath","store","beforeEach","mkdtempSync","join","tmpdir","afterEach","rmSync","recursive","force","sampleEntry","type","enabled","createdAt","config","botToken","botUsername","it","defaultStore","getConfig","expect","toBeDefined","toEqual","channels","writeFileSync","JSON","stringify","telegram","saveChannel","raw","readFileSync","parse","nestedPath","nestedStore","existsSync","toBe","stats","statSync","mode","toString","Object","keys","authorizedChatId","personal","work","removeChannel","toBeUndefined","resolves","entry","getChannel"],"mappings":"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"}
+{"version":3,"sources":["../../src/__tests__/ConfigStore.test.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport { ConfigStore } from '../ConfigStore.js';\nimport { isSlackEntry } from '../types.js';\nimport type { ChannelEntry } from '../types.js';\n\ndescribe('ConfigStore', () => {\n    let tmpDir: string;\n    let configPath: string;\n    let store: ConfigStore;\n\n    beforeEach(() => {\n        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'channel-connector-test-'));\n        configPath = path.join(tmpDir, 'channels.json');\n        store = new ConfigStore(configPath);\n    });\n\n    afterEach(() => {\n        fs.rmSync(tmpDir, { recursive: true, force: true });\n    });\n\n    const sampleEntry: ChannelEntry = {\n        type: 'telegram',\n        enabled: true,\n        createdAt: '2026-04-11T00:00:00Z',\n        config: {\n            botToken: 'test-token-123',\n            botUsername: 'test_bot',\n        },\n    };\n\n    const slackEntry: ChannelEntry = {\n        type: 'slack',\n        enabled: true,\n        createdAt: '2026-08-06T00:00:00Z',\n        config: {\n            appToken: 'xapp-fake',\n            botToken: 'xoxb-fake',\n            appId: 'A123',\n            botUserId: 'U-BOT',\n            workspaceId: 'T123',\n            workspaceName: 'Sandbox',\n            transport: 'socket-mode',\n            audience: 'dm',\n        },\n    };\n\n    describe('constructor', () => {\n        it('should use default path when no configPath provided', async () => {\n            const defaultStore = new ConfigStore();\n            // Should not throw — just uses default path\n            const config = await defaultStore.getConfig();\n            expect(config).toBeDefined();\n        });\n    });\n\n    describe('getConfig', () => {\n        it('narrows provider configuration from the channel type', () => {\n            expect(isSlackEntry(slackEntry)).toBe(true);\n            if (!isSlackEntry(slackEntry)) throw new Error('expected Slack entry');\n            expect(slackEntry.config.workspaceId).toBe('T123');\n        });\n\n        it('should return default empty config when file does not exist', async () => {\n            const config = await store.getConfig();\n            expect(config).toEqual({ channels: {} });\n        });\n\n        it('should return parsed config when file exists', async () => {\n            fs.writeFileSync(configPath, JSON.stringify({\n                channels: { telegram: sampleEntry }\n            }));\n\n            const config = await store.getConfig();\n            expect(config.channels.telegram).toEqual(sampleEntry);\n        });\n\n        it('should handle corrupted JSON gracefully', async () => {\n            fs.writeFileSync(configPath, 'not valid json{{{');\n\n            const config = await store.getConfig();\n            expect(config).toEqual({ channels: {} });\n        });\n    });\n\n    describe('saveChannel', () => {\n        it('should create config file with channel entry', async () => {\n            await store.saveChannel('telegram', sampleEntry);\n\n            const raw = fs.readFileSync(configPath, 'utf-8');\n            const config = JSON.parse(raw);\n            expect(config.channels.telegram).toEqual(sampleEntry);\n        });\n\n        it('should create parent directory if missing', async () => {\n            const nestedPath = path.join(tmpDir, 'nested', 'dir', 'channels.json');\n            const nestedStore = new ConfigStore(nestedPath);\n\n            await nestedStore.saveChannel('telegram', sampleEntry);\n\n            expect(fs.existsSync(nestedPath)).toBe(true);\n        });\n\n        it('should set file permissions to 0600', async () => {\n            await store.saveChannel('telegram', sampleEntry);\n\n            const stats = fs.statSync(configPath);\n            const mode = (stats.mode & 0o777).toString(8);\n            expect(mode).toBe('600');\n        });\n\n        it('should repair permissive permissions on an existing config file', async () => {\n            fs.writeFileSync(configPath, JSON.stringify({ channels: {} }), { mode: 0o644 });\n            fs.chmodSync(configPath, 0o644);\n\n            await store.saveChannel('slack', slackEntry);\n\n            expect(fs.statSync(configPath).mode & 0o777).toBe(0o600);\n        });\n\n        it('should preserve existing channels when adding a new one', async () => {\n            await store.saveChannel('telegram', sampleEntry);\n            await store.saveChannel('slack', slackEntry);\n\n            const config = await store.getConfig();\n            expect(Object.keys(config.channels)).toEqual(['telegram', 'slack']);\n            expect(config.channels.slack).toEqual(slackEntry);\n        });\n\n        it('should preserve separate Telegram configs by channel name', async () => {\n            await store.saveChannel('personal', {\n                ...sampleEntry,\n                config: {\n                    botToken: 'personal-token',\n                    botUsername: 'personal_bot',\n                    authorizedChatId: 111,\n                },\n            });\n            await store.saveChannel('work', {\n                ...sampleEntry,\n                config: {\n                    botToken: 'work-token',\n                    botUsername: 'work_bot',\n                    authorizedChatId: 222,\n                },\n            });\n\n            const config = await store.getConfig();\n            expect(config.channels.personal.config).toEqual({\n                botToken: 'personal-token',\n                botUsername: 'personal_bot',\n                authorizedChatId: 111,\n            });\n            expect(config.channels.work.config).toEqual({\n                botToken: 'work-token',\n                botUsername: 'work_bot',\n                authorizedChatId: 222,\n            });\n        });\n    });\n\n    describe('removeChannel', () => {\n        it('should remove a channel entry', async () => {\n            await store.saveChannel('telegram', sampleEntry);\n            await store.removeChannel('telegram');\n\n            const config = await store.getConfig();\n            expect(config.channels.telegram).toBeUndefined();\n        });\n\n        it('should not throw when removing non-existent channel', async () => {\n            await expect(store.removeChannel('nonexistent')).resolves.toBeUndefined();\n        });\n    });\n\n    describe('getChannel', () => {\n        it('should return the channel entry', async () => {\n            await store.saveChannel('telegram', sampleEntry);\n\n            const entry = await store.getChannel('telegram');\n            expect(entry).toEqual(sampleEntry);\n        });\n\n        it('should return undefined for non-existent channel', async () => {\n            const entry = await store.getChannel('slack');\n            expect(entry).toBeUndefined();\n        });\n    });\n});\n"],"names":["fs","path","os","ConfigStore","isSlackEntry","describe","tmpDir","configPath","store","beforeEach","mkdtempSync","join","tmpdir","afterEach","rmSync","recursive","force","sampleEntry","type","enabled","createdAt","config","botToken","botUsername","slackEntry","appToken","appId","botUserId","workspaceId","workspaceName","transport","audience","it","defaultStore","getConfig","expect","toBeDefined","toBe","Error","toEqual","channels","writeFileSync","JSON","stringify","telegram","saveChannel","raw","readFileSync","parse","nestedPath","nestedStore","existsSync","stats","statSync","mode","toString","chmodSync","Object","keys","slack","authorizedChatId","personal","work","removeChannel","toBeUndefined","resolves","entry","getChannel"],"mappings":"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"}

package/dist/__tests__/adapters/SlackAdapter.test.js

@@ -0,0 +1,429 @@
+import { EventEmitter } from 'node:events';
+import { SlackAdapter, validateSlackAppToken, validateSlackCredentials } from '../../adapters/SlackAdapter.js';
+let FakeSocketClient = class FakeSocketClient extends EventEmitter {
+    start = vi.fn().mockResolvedValue(undefined);
+    disconnect = vi.fn().mockResolvedValue(undefined);
+};
+const config = {
+    appToken: 'xapp-fake',
+    botToken: 'xoxb-fake',
+    appId: 'A123',
+    botUserId: 'U-BOT',
+    workspaceId: 'T123',
+    transport: 'socket-mode',
+    audience: 'dm'
+};
+function envelope(overrides = {}) {
+    return {
+        type: 'events_api',
+        ack: vi.fn().mockResolvedValue(undefined),
+        body: {
+            team_id: 'T123',
+            event_id: 'Ev123',
+            event: {
+                type: 'message',
+                channel_type: 'im',
+                channel: 'D123',
+                user: 'U123',
+                text: 'run tests',
+                ts: '100.1',
+                event_ts: '100.1',
+                ...overrides
+            }
+        }
+    };
+}
+describe('SlackAdapter', ()=>{
+    it('validates bot identity without returning either credential', async ()=>{
+        const authTest = vi.fn().mockResolvedValue({
+            ok: true,
+            app_id: 'A123',
+            user_id: 'U-BOT',
+            team_id: 'T123',
+            team: 'Sandbox'
+        });
+        await expect(validateSlackCredentials('xoxb-fake', {
+            authTest
+        })).resolves.toEqual({
+            appId: 'A123',
+            botUserId: 'U-BOT',
+            workspaceId: 'T123',
+            workspaceName: 'Sandbox'
+        });
+    });
+    it('accepts Slack documented bot identity without an app ID', async ()=>{
+        const authTest = vi.fn().mockResolvedValue({
+            ok: true,
+            bot_id: 'B123',
+            user_id: 'U-BOT',
+            team_id: 'T123',
+            team: 'Sandbox'
+        });
+        await expect(validateSlackCredentials('xoxb-fake', {
+            authTest
+        })).resolves.toEqual({
+            botUserId: 'U-BOT',
+            workspaceId: 'T123',
+            workspaceName: 'Sandbox'
+        });
+    });
+    it('rejects incomplete Slack credential identity', async ()=>{
+        const authTest = vi.fn().mockResolvedValue({
+            ok: true,
+            team_id: 'T123'
+        });
+        await expect(validateSlackCredentials('xoxb-fake', {
+            authTest
+        })).rejects.toThrow('Slack bot token returned incomplete identity');
+    });
+    it('validates an app token through apps.connections.open', async ()=>{
+        const open = vi.fn().mockResolvedValue({
+            ok: true,
+            url: 'wss://wss-primary.slack.com/link/'
+        });
+        await expect(validateSlackAppToken('xapp-fake', {
+            open
+        })).resolves.toBeUndefined();
+        expect(open).toHaveBeenCalledOnce();
+    });
+    it('rejects an app token that cannot open Socket Mode', async ()=>{
+        const open = vi.fn().mockResolvedValue({
+            ok: false
+        });
+        await expect(validateSlackAppToken('xapp-fake', {
+            open
+        })).rejects.toThrow('Slack app token cannot open Socket Mode');
+    });
+    it('starts and stops the official Socket Mode client and reports health', async ()=>{
+        const socket = new FakeSocketClient();
+        const adapter = new SlackAdapter(config, {
+            socketClient: socket,
+            webClient: {
+                chat: {
+                    postMessage: vi.fn()
+                }
+            }
+        });
+        expect(await adapter.isHealthy()).toBe(false);
+        await adapter.start();
+        expect(socket.start).toHaveBeenCalledOnce();
+        expect(await adapter.isHealthy()).toBe(true);
+        await adapter.stop();
+        expect(socket.disconnect).toHaveBeenCalledOnce();
+        expect(await adapter.isHealthy()).toBe(false);
+    });
+    it('does not register duplicate listeners across restarts', async ()=>{
+        const socket = new FakeSocketClient();
+        const adapter = new SlackAdapter(config, {
+            socketClient: socket,
+            webClient: {
+                chat: {
+                    postMessage: vi.fn()
+                }
+            }
+        });
+        await adapter.start();
+        await adapter.stop();
+        await adapter.start();
+        expect(socket.listenerCount('slack_event')).toBe(1);
+        expect(socket.listenerCount('interactive')).toBe(1);
+        socket.emit('disconnected');
+        expect(await adapter.isHealthy()).toBe(false);
+        socket.emit('connected');
+        expect(await adapter.isHealthy()).toBe(true);
+    });
+    it('acknowledges before delivering one normalized workspace DM event', async ()=>{
+        const socket = new FakeSocketClient();
+        const adapter = new SlackAdapter(config, {
+            socketClient: socket,
+            webClient: {
+                chat: {
+                    postMessage: vi.fn()
+                }
+            }
+        });
+        const order = [];
+        adapter.onMessage(vi.fn(async (message)=>{
+            order.push('handler');
+            expect(message).toMatchObject({
+                channelType: 'slack',
+                chatId: 'D123',
+                userId: 'U123',
+                workspaceId: 'T123',
+                messageId: 'Ev123',
+                text: 'run tests'
+            });
+        }));
+        await adapter.start();
+        const item = envelope();
+        item.ack.mockImplementation(async ()=>{
+            order.push('ack');
+        });
+        socket.emit('slack_event', item);
+        await vi.waitFor(()=>expect(order).toEqual([
+                'ack',
+                'handler'
+            ]));
+        socket.emit('slack_event', item);
+        await new Promise((resolve)=>setTimeout(resolve, 0));
+        expect(order).toEqual([
+            'ack',
+            'handler',
+            'ack'
+        ]);
+    });
+    it.each([
+        [
+            'wrong workspace',
+            {},
+            {
+                team_id: 'T999'
+            }
+        ],
+        [
+            'bot message',
+            {
+                bot_id: 'B123'
+            },
+            {}
+        ],
+        [
+            'self message',
+            {
+                user: 'U-BOT'
+            },
+            {}
+        ],
+        [
+            'subtype',
+            {
+                subtype: 'message_changed'
+            },
+            {}
+        ],
+        [
+            'non-DM',
+            {
+                channel_type: 'channel'
+            },
+            {}
+        ]
+    ])('ignores %s events', async (_name, eventOverrides, bodyOverrides)=>{
+        const socket = new FakeSocketClient();
+        const handler = vi.fn();
+        const adapter = new SlackAdapter(config, {
+            socketClient: socket,
+            webClient: {
+                chat: {
+                    postMessage: vi.fn()
+                }
+            }
+        });
+        adapter.onMessage(handler);
+        await adapter.start();
+        const item = envelope(eventOverrides);
+        Object.assign(item.body, bodyOverrides);
+        socket.emit('slack_event', item);
+        await vi.waitFor(()=>expect(item.ack).toHaveBeenCalled());
+        expect(handler).not.toHaveBeenCalled();
+    });
+    it('delivers an ordinary workspace DM immediately without pairing', async ()=>{
+        const socket = new FakeSocketClient();
+        const handler = vi.fn();
+        const adapter = new SlackAdapter(config, {
+            socketClient: socket,
+            webClient: {
+                chat: {
+                    postMessage: vi.fn()
+                }
+            }
+        });
+        adapter.onMessage(handler);
+        await adapter.start();
+        socket.emit('slack_event', envelope({
+            text: 'run tests'
+        }));
+        await vi.waitFor(()=>expect(handler).toHaveBeenCalledWith(expect.objectContaining({
+                chatId: 'D123',
+                userId: 'U123',
+                text: 'run tests',
+                workspaceId: 'T123'
+            })));
+    });
+    it('sends an accessible Block Kit question and finalizes its actions', async ()=>{
+        const socket = new FakeSocketClient();
+        const postMessage = vi.fn().mockResolvedValue({
+            ok: true,
+            ts: '400.1'
+        });
+        const update = vi.fn().mockResolvedValue({
+            ok: true
+        });
+        const adapter = new SlackAdapter(config, {
+            socketClient: socket,
+            webClient: {
+                chat: {
+                    postMessage,
+                    update
+                }
+            }
+        });
+        await expect(adapter.sendQuestion('D123', {
+            id: 'q1',
+            header: 'Scope',
+            question: 'Choose one',
+            allowSkip: true,
+            options: [
+                {
+                    label: 'Safe',
+                    description: 'Read only',
+                    value: '1'
+                }
+            ]
+        })).resolves.toEqual({
+            messageId: '400.1'
+        });
+        expect(postMessage).toHaveBeenCalledWith(expect.objectContaining({
+            channel: 'D123',
+            text: 'Scope: Choose one',
+            blocks: expect.any(Array)
+        }));
+        await adapter.finalizeInteraction('D123', '400.1');
+        expect(update).toHaveBeenCalledWith({
+            channel: 'D123',
+            ts: '400.1',
+            blocks: []
+        });
+    });
+    it('escapes Slack control syntax in question fallback text', async ()=>{
+        const postMessage = vi.fn().mockResolvedValue({
+            ok: true,
+            ts: '400.1'
+        });
+        const adapter = new SlackAdapter(config, {
+            socketClient: new FakeSocketClient(),
+            webClient: {
+                chat: {
+                    postMessage
+                }
+            }
+        });
+        await adapter.sendQuestion('D123', {
+            id: 'q1',
+            header: '<!channel>',
+            question: 'Choose <one> & continue',
+            allowSkip: false,
+            options: [
+                {
+                    label: 'Safe',
+                    value: '1'
+                }
+            ]
+        });
+        expect(postMessage).toHaveBeenCalledWith(expect.objectContaining({
+            text: '&lt;!channel&gt;: Choose &lt;one&gt; &amp; continue'
+        }));
+    });
+    it('acknowledges and delivers one valid workspace block action', async ()=>{
+        const socket = new FakeSocketClient();
+        const handler = vi.fn();
+        const adapter = new SlackAdapter(config, {
+            socketClient: socket,
+            webClient: {
+                chat: {
+                    postMessage: vi.fn()
+                }
+            }
+        });
+        adapter.onInteraction(handler);
+        await adapter.start();
+        const item = {
+            ack: vi.fn().mockResolvedValue(undefined),
+            body: {
+                type: 'block_actions',
+                team: {
+                    id: 'T123'
+                },
+                user: {
+                    id: 'U123'
+                },
+                channel: {
+                    id: 'D123'
+                },
+                container: {
+                    message_ts: '400.1'
+                },
+                actions: [
+                    {
+                        action_id: 'ai_devkit_question',
+                        action_ts: '401.1',
+                        value: 'q1:1'
+                    }
+                ]
+            }
+        };
+        socket.emit('interactive', item);
+        await vi.waitFor(()=>expect(handler).toHaveBeenCalledOnce());
+        expect(item.ack).toHaveBeenCalledOnce();
+        expect(handler).toHaveBeenCalledWith(expect.objectContaining({
+            workspaceId: 'T123',
+            chatId: 'D123',
+            userId: 'U123',
+            messageId: '400.1',
+            value: 'q1:1'
+        }));
+        socket.emit('interactive', item);
+        await new Promise((resolve)=>setTimeout(resolve, 0));
+        expect(handler).toHaveBeenCalledOnce();
+        expect(item.ack).toHaveBeenCalledTimes(2);
+    });
+    it('does not acknowledge interactive envelopes a second time on the generic event stream', async ()=>{
+        const socket = new FakeSocketClient();
+        const adapter = new SlackAdapter(config, {
+            socketClient: socket,
+            webClient: {
+                chat: {
+                    postMessage: vi.fn()
+                }
+            }
+        });
+        await adapter.start();
+        const ack = vi.fn().mockResolvedValue(undefined);
+        socket.emit('slack_event', {
+            type: 'interactive',
+            ack,
+            body: {}
+        });
+        await new Promise((resolve)=>setTimeout(resolve, 0));
+        expect(ack).not.toHaveBeenCalled();
+    });
+    it('acknowledges malformed and wrong-workspace block actions without delivery', async ()=>{
+        const socket = new FakeSocketClient();
+        const handler = vi.fn();
+        const adapter = new SlackAdapter(config, {
+            socketClient: socket,
+            webClient: {
+                chat: {
+                    postMessage: vi.fn()
+                }
+            }
+        });
+        adapter.onInteraction(handler);
+        await adapter.start();
+        const ack = vi.fn().mockResolvedValue(undefined);
+        socket.emit('interactive', {
+            ack,
+            body: {
+                type: 'block_actions',
+                team: {
+                    id: 'T999'
+                },
+                actions: []
+            }
+        });
+        await vi.waitFor(()=>expect(ack).toHaveBeenCalled());
+        expect(handler).not.toHaveBeenCalled();
+    });
+});
+
+//# sourceMappingURL=SlackAdapter.test.js.map