1export const openaiRealtimeIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'ai-voice-conv.openai',
4		version: '1.0.0',
5		category: 'ai-voice-conversational',
6		title: 'OpenAI Realtime Voice',
7		description:
8			'OpenAI Realtime API integration for bidirectional conversational voice with GPT models.',
9		domain: 'ai',
10		owners: ['platform.ai'],
11		tags: ['voice', 'conversational', 'realtime', 'openai'],
12		stability: StabilityEnum.Experimental,
13	},
14	supportedModes: ['byok'],
15	transports: [
16		{ type: 'rest', baseUrl: 'https://api.openai.com' },
17		{ type: 'sdk', packageName: 'openai' },
18	] satisfies IntegrationTransportConfig[],
19	preferredTransport: 'sdk',
20	supportedAuthMethods: [
21		{ type: 'api-key', headerName: 'Authorization', prefix: 'Bearer ' },
22	] satisfies IntegrationAuthConfig[],
23	capabilities: {
24		provides: [{ key: 'ai.voice.conversational', version: '1.0.0' }],
25	},
26	configSchema: {
27		schema: {
28			type: 'object',
29			properties: {
30				model: {
31					type: 'string',
32					description:
33						'OpenAI model for realtime conversations (e.g. gpt-4o-realtime-preview).',
34				},
35				defaultVoice: {
36					type: 'string',
37					description:
38						'Default voice for agent responses (e.g. alloy, echo, shimmer).',
39				},
40				turnDetection: {
41					type: 'string',
42					enum: ['server_vad', 'push_to_talk'],
43					description: 'Turn detection strategy.',
44				},
45				maxSessionDurationSeconds: {
46					type: 'number',
47					description: 'Maximum session duration in seconds.',
48				},
49			},
50		},
51		example: {
52			model: 'gpt-4o-realtime-preview',
53			defaultVoice: 'alloy',
54			turnDetection: 'server_vad',
55			maxSessionDurationSeconds: 600,
56		},
57	},
58	secretSchema: {
59		schema: {
60			type: 'object',
61			required: ['apiKey'],
62			properties: {
63				apiKey: {
64					type: 'string',
65					description: 'OpenAI API key with realtime API access.',
66				},
67			},
68		},
69		example: {
70			apiKey: 'sk-***',
71		},
72	},
73	healthCheck: {
74		method: 'custom',
75		timeoutMs: 5000,
76	},
77	docsUrl: 'https://platform.openai.com/docs/guides/realtime',
78	byokSetup: {
79		setupInstructions:
80			'Create an OpenAI API key with Realtime API access enabled and store it in your secret provider.',
81		keyRotationSupported: true,
82		quotaTrackingSupported: true,
83	},
84});