1export const mistralSttIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'ai-voice-stt.mistral',
4		version: '1.0.0',
5		category: 'ai-voice-stt',
6		title: 'Mistral Speech-to-Text',
7		description:
8			'Mistral audio transcription integration for batch and streaming speech-to-text use cases.',
9		domain: 'ai',
10		owners: ['platform.ai'],
11		tags: ['voice', 'stt', 'transcription', 'mistral', 'voxtral'],
12		stability: StabilityEnum.Experimental,
13	},
14	supportedModes: ['managed', 'byok'],
15	transports: [
16		{ type: 'rest', baseUrl: 'https://api.mistral.ai' },
17	] satisfies IntegrationTransportConfig[],
18	preferredTransport: 'rest',
19	supportedAuthMethods: [
20		{ type: 'api-key', headerName: 'Authorization', prefix: 'Bearer ' },
21	] satisfies IntegrationAuthConfig[],
22	capabilities: {
23		provides: [{ key: 'ai.voice.stt', version: '1.0.0' }],
24	},
25	configSchema: {
26		schema: {
27			type: 'object',
28			properties: {
29				model: {
30					type: 'string',
31					description:
32						'Mistral transcription model identifier (e.g. voxtral-mini-latest).',
33				},
34				language: {
35					type: 'string',
36					description: 'Default language code for transcription (e.g. en).',
37				},
38				diarize: {
39					type: 'boolean',
40					description:
41						'Enable speaker diarization when supported by the model.',
42				},
43				wordTimestamps: {
44					type: 'boolean',
45					description: 'Include word-level timestamp metadata when available.',
46				},
47			},
48		},
49		example: {
50			model: 'voxtral-mini-latest',
51			language: 'en',
52			diarize: true,
53			wordTimestamps: true,
54		},
55	},
56	secretSchema: {
57		schema: {
58			type: 'object',
59			required: ['apiKey'],
60			properties: {
61				apiKey: {
62					type: 'string',
63					description:
64						'Mistral API key with access to audio transcription endpoints.',
65				},
66			},
67		},
68		example: {
69			apiKey: 'mistral-***',
70		},
71	},
72	healthCheck: {
73		method: 'custom',
74		timeoutMs: 5000,
75	},
76	docsUrl: 'https://docs.mistral.ai/api/#tag/audio',
77	byokSetup: {
78		setupInstructions:
79			'Generate a Mistral API key and ensure the project has access to Voxtral or another transcription-capable model.',
80		keyRotationSupported: true,
81		quotaTrackingSupported: true,
82	},
83});