1export const deepgramIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'ai-voice-stt.deepgram',
4		version: '1.0.0',
5		category: 'ai-voice-stt',
6		title: 'Deepgram Speech-to-Text',
7		description:
8			'Deepgram integration for real-time and batch speech-to-text transcription with speaker diarization.',
9		domain: 'ai',
10		owners: ['platform.ai'],
11		tags: ['voice', 'stt', 'transcription', 'diarization'],
12		stability: StabilityEnum.Experimental,
13	},
14	supportedModes: ['byok'],
15	transports: [
16		{ type: 'rest', baseUrl: 'https://api.deepgram.com' },
17		{ type: 'sdk', packageName: '@deepgram/sdk' },
18	] satisfies IntegrationTransportConfig[],
19	preferredTransport: 'sdk',
20	supportedAuthMethods: [
21		{ type: 'api-key', headerName: 'Authorization', prefix: 'Token ' },
22	] satisfies IntegrationAuthConfig[],
23	capabilities: {
24		provides: [
25			{ key: 'ai.voice.stt', version: '1.0.0' },
26			{ key: 'ai.voice.conversational', version: '1.0.0' },
27		],
28	},
29	configSchema: {
30		schema: {
31			type: 'object',
32			properties: {
33				model: {
34					type: 'string',
35					description: 'Deepgram model to use (e.g. nova-3, nova-2, enhanced).',
36				},
37				language: {
38					type: 'string',
39					description: 'Default language code for transcription (e.g. en-US).',
40				},
41				enableDiarization: {
42					type: 'boolean',
43					description: 'Enable speaker diarization by default.',
44				},
45				enableSmartFormat: {
46					type: 'boolean',
47					description: 'Enable smart formatting (punctuation, capitalization).',
48				},
49			},
50		},
51		example: {
52			model: 'nova-3',
53			language: 'en-US',
54			enableDiarization: true,
55			enableSmartFormat: true,
56		},
57	},
58	secretSchema: {
59		schema: {
60			type: 'object',
61			required: ['apiKey'],
62			properties: {
63				apiKey: {
64					type: 'string',
65					description: 'Deepgram API key with transcription permissions.',
66				},
67			},
68		},
69		example: {
70			apiKey: 'dg_***',
71		},
72	},
73	healthCheck: {
74		method: 'custom',
75		timeoutMs: 5000,
76	},
77	docsUrl: 'https://developers.deepgram.com/docs',
78	byokSetup: {
79		setupInstructions:
80			'Create a Deepgram API key with speech-to-text permissions and store it in your secret provider.',
81		keyRotationSupported: true,
82		quotaTrackingSupported: true,
83	},
84});