1export const mistralConversationalIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'ai-voice-conv.mistral',
4		version: '1.0.0',
5		category: 'ai-voice-conversational',
6		title: 'Mistral Conversational Voice',
7		description:
8			'Mistral conversational voice integration using conversation sessions and speech models for bidirectional interactions.',
9		domain: 'ai',
10		owners: ['platform.ai'],
11		tags: ['voice', 'conversational', 'mistral', 'agents', 'sessions'],
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.conversational', version: '1.0.0' }],
24	},
25	configSchema: {
26		schema: {
27			type: 'object',
28			properties: {
29				model: {
30					type: 'string',
31					description:
32						'Mistral model used for response generation in conversational sessions.',
33				},
34				defaultVoice: {
35					type: 'string',
36					description: 'Default voice profile for agent responses.',
37				},
38				turnDetection: {
39					type: 'string',
40					enum: ['server_vad', 'push_to_talk'],
41					description:
42						'Turn detection strategy used during live conversations.',
43				},
44				maxSessionDurationSeconds: {
45					type: 'number',
46					description: 'Maximum allowed conversational session duration.',
47				},
48			},
49		},
50		example: {
51			model: 'mistral-medium-latest',
52			defaultVoice: 'default',
53			turnDetection: 'server_vad',
54			maxSessionDurationSeconds: 600,
55		},
56	},
57	secretSchema: {
58		schema: {
59			type: 'object',
60			required: ['apiKey'],
61			properties: {
62				apiKey: {
63					type: 'string',
64					description:
65						'Mistral API key with access to conversational and agent APIs.',
66				},
67			},
68		},
69		example: {
70			apiKey: 'mistral-***',
71		},
72	},
73	healthCheck: {
74		method: 'custom',
75		timeoutMs: 5000,
76	},
77	docsUrl: 'https://docs.mistral.ai/agents/agents',
78	byokSetup: {
79		setupInstructions:
80			'Create a Mistral API key, enable conversation-capable models for your account, and configure default turn detection settings.',
81		keyRotationSupported: true,
82		quotaTrackingSupported: true,
83	},
84});