1export const messagingSlackIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'messaging.slack',
4		version: '1.0.0',
5		category: 'messaging',
6		title: 'Slack Messaging Platform',
7		description:
8			'Slack integration for inbound events, threaded responses, and interactive messaging workflows.',
9		domain: 'communications',
10		owners: ['platform.messaging'],
11		tags: ['messaging', 'slack'],
12		stability: StabilityEnum.Beta,
13	},
14	supportedModes: ['managed', 'byok'],
15	transports: [
16		{ type: 'rest', baseUrl: 'https://slack.com/api' },
17		{
18			type: 'webhook',
19			inbound: {
20				signatureHeader: 'x-slack-signature',
21				signingAlgorithm: 'hmac-sha256',
22			},
23		},
24		{ type: 'sdk', packageName: '@slack/web-api' },
25	],
26	preferredTransport: 'rest',
27	supportedAuthMethods: [
28		{
29			type: 'oauth2',
30			grantType: 'authorization_code',
31			authorizationUrl: 'https://slack.com/oauth/v2/authorize',
32			tokenUrl: 'https://slack.com/api/oauth.v2.access',
33			scopes: ['chat:write', 'channels:history', 'commands'],
34		},
35		{ type: 'bearer' },
36		{
37			type: 'webhook-signing',
38			algorithm: 'hmac-sha256',
39			signatureHeader: 'x-slack-signature',
40		},
41	],
42	capabilities: {
43		provides: [
44			{ key: 'messaging.inbound', version: '1.0.0' },
45			{ key: 'messaging.outbound', version: '1.0.0' },
46			{ key: 'messaging.interactions', version: '1.0.0' },
47		],
48	},
49	configSchema: {
50		schema: {
51			type: 'object',
52			properties: {
53				defaultChannelId: {
54					type: 'string',
55					description:
56						'Optional default Slack channel ID for outbound messages.',
57				},
58				allowUserMentions: {
59					type: 'boolean',
60					description:
61						'Whether user mention expansion is enabled in responses.',
62				},
63			},
64		},
65		example: {
66			defaultChannelId: 'C0123456789',
67			allowUserMentions: true,
68		},
69	},
70	secretSchema: {
71		schema: {
72			type: 'object',
73			required: ['botToken', 'signingSecret'],
74			properties: {
75				botToken: {
76					type: 'string',
77					description: 'Slack bot token used for Web API calls.',
78				},
79				signingSecret: {
80					type: 'string',
81					description: 'Slack signing secret used to verify inbound webhooks.',
82				},
83				appToken: {
84					type: 'string',
85					description:
86						'Optional app-level token for socket mode or advanced API usage.',
87				},
88			},
89		},
90		example: {
91			botToken: 'xoxb-***',
92			signingSecret: '***',
93		},
94	},
95	healthCheck: {
96		method: 'custom',
97		timeoutMs: 4000,
98	},
99	docsUrl: 'https://api.slack.com',
100	constraints: {
101		rateLimit: {
102			rpm: 200,
103		},
104	},
105	byokSetup: {
106		setupInstructions:
107			'Create a Slack app, install it to your workspace, then provide bot token and signing secret.',
108		requiredScopes: ['chat:write', 'channels:history', 'commands'],
109		keyRotationSupported: true,
110		quotaTrackingSupported: false,
111	},
112});