1export const twilioSmsIntegrationSpec = defineIntegration({
2  meta: {
3    key: 'sms.twilio',
4    version: '1.0.0',
5    category: 'sms',
6    title: 'Twilio Messaging',
7    description:
8      'Twilio SMS integration for transactional and notification messaging.',
9    domain: 'communications',
10    owners: ['platform.messaging'],
11    tags: ['sms', 'messaging'],
12    stability: StabilityEnum.Stable,
13  },
14  supportedModes: ['managed', 'byok'],
15  capabilities: {
16    provides: [{ key: 'sms.outbound', version: '1.0.0' }],
17  },
18  configSchema: {
19    schema: {
20      type: 'object',
21      properties: {
22        fromNumber: {
23          type: 'string',
24          description: 'Default Twilio phone number used as sender.',
25        },
26      },
27    },
28    example: {
29      fromNumber: '+15551234567',
30    },
31  },
32  secretSchema: {
33    schema: {
34      type: 'object',
35      required: ['accountSid', 'authToken'],
36      properties: {
37        accountSid: {
38          type: 'string',
39          description: 'Twilio Account SID.',
40        },
41        authToken: {
42          type: 'string',
43          description: 'Twilio Auth Token.',
44        },
45      },
46    },
47    example: {
48      accountSid: 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
49      authToken: 'auth-token',
50    },
51  },
52  healthCheck: {
53    method: 'custom',
54    timeoutMs: 3000,
55  },
56  docsUrl: 'https://www.twilio.com/docs/sms/api',
57  constraints: {
58    rateLimit: {
59      rpm: 200,
60    },
61  },
62  byokSetup: {
63    setupInstructions:
64      'Provide a Twilio account SID, auth token, and verify the outbound sending numbers used by the integration.',
65  },
66});