1export const gradiumIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'ai-voice.gradium',
4		version: '1.0.0',
5		category: 'ai-voice-tts',
6		title: 'Gradium Text-to-Speech',
7		description:
8			'Gradium integration for low-latency voice synthesis and voice catalog access.',
9		domain: 'ai',
10		owners: ['platform.ai'],
11		tags: ['voice', 'tts', 'realtime'],
12		stability: StabilityEnum.Experimental,
13	},
14	supportedModes: ['byok'],
15	transports: [{ type: 'rest' }] satisfies IntegrationTransportConfig[],
16	preferredTransport: 'rest',
17	supportedAuthMethods: [{ type: 'api-key' }] satisfies IntegrationAuthConfig[],
18	capabilities: {
19		provides: [{ key: 'ai.voice.tts', version: '1.0.0' }],
20	},
21	configSchema: {
22		schema: {
23			type: 'object',
24			properties: {
25				defaultVoiceId: {
26					type: 'string',
27					description: 'Optional default voice identifier used for synthesis.',
28				},
29				region: {
30					type: 'string',
31					enum: ['eu', 'us'],
32					description: 'Gradium region used by the SDK (eu or us).',
33				},
34				baseUrl: {
35					type: 'string',
36					description:
37						'Optional API base URL override for private routing or proxies.',
38				},
39				timeoutMs: {
40					type: 'number',
41					description: 'Optional request timeout in milliseconds.',
42				},
43				outputFormat: {
44					type: 'string',
45					enum: [
46						'wav',
47						'pcm',
48						'opus',
49						'ulaw_8000',
50						'alaw_8000',
51						'pcm_16000',
52						'pcm_24000',
53					],
54					description:
55						'Optional default output format used when no format is specified.',
56				},
57			},
58		},
59		example: {
60			defaultVoiceId: 'YTpq7expH9539ERJ',
61			region: 'eu',
62			timeoutMs: 15000,
63			outputFormat: 'wav',
64		},
65	},
66	secretSchema: {
67		schema: {
68			type: 'object',
69			required: ['apiKey'],
70			properties: {
71				apiKey: {
72					type: 'string',
73					description: 'Gradium API key with TTS access.',
74				},
75			},
76		},
77		example: {
78			apiKey: 'gd_***',
79		},
80	},
81	healthCheck: {
82		method: 'custom',
83		timeoutMs: 5000,
84	},
85	docsUrl: 'https://gradium.ai/api_docs.html',
86	byokSetup: {
87		setupInstructions:
88			'Create a Gradium API key, select the target region, and store credentials in your tenant secret provider.',
89		keyRotationSupported: false,
90		quotaTrackingSupported: false,
91	},
92});