1export const composioIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'fallback.composio',
4		version: '1.0.0',
5		category: 'custom',
6		title: 'Composio Universal Fallback',
7		description:
8			'Composio integration platform providing 850+ toolkits as a universal fallback for unsupported provider keys.',
9		domain: 'platform',
10		owners: ['platform.integrations'],
11		tags: ['composio', 'fallback', 'mcp', 'universal'],
12		stability: StabilityEnum.Beta,
13	},
14	supportedModes: ['managed', 'byok'],
15	transports: [
16		{
17			type: 'mcp',
18			transport: 'http',
19			toolPrefix: 'composio',
20		},
21		{
22			type: 'sdk',
23			packageName: '@composio/core',
24			runtime: 'universal',
25		},
26	],
27	preferredTransport: 'mcp',
28	supportedAuthMethods: [{ type: 'api-key', headerName: 'X-API-Key' }],
29	capabilities: {
30		provides: [{ key: 'integration.fallback', version: '1.0.0' }],
31	},
32	configSchema: {
33		schema: {
34			type: 'object',
35			properties: {
36				baseUrl: {
37					type: 'string',
38					description:
39						'Custom Composio API base URL (for self-hosted or enterprise).',
40				},
41				preferredTransport: {
42					type: 'string',
43					enum: ['mcp', 'sdk'],
44					description:
45						'Preferred transport mode: mcp (default) or sdk (advanced).',
46				},
47				toolkits: {
48					type: 'array',
49					items: { type: 'string' },
50					description: 'Restrict available toolkits (empty = all).',
51				},
52			},
53		},
54		example: {
55			preferredTransport: 'mcp',
56			toolkits: ['github', 'slack', 'gmail'],
57		},
58	},
59	secretSchema: {
60		schema: {
61			type: 'object',
62			required: ['apiKey'],
63			properties: {
64				apiKey: {
65					type: 'string',
66					description: 'Composio API key (COMPOSIO_API_KEY).',
67				},
68			},
69		},
70		example: {
71			apiKey: 'comp_***',
72		},
73	},
74	healthCheck: {
75		method: 'ping',
76		timeoutMs: 5000,
77	},
78	docsUrl: 'https://docs.composio.dev',
79	byokSetup: {
80		setupInstructions:
81			'Sign up at composio.dev, create an API key from the dashboard, and provide it as the apiKey secret.',
82		requiredScopes: [],
83		keyRotationSupported: false,
84		quotaTrackingSupported: true,
85		provisioningSteps: [
86			'Create a Composio account at https://composio.dev',
87			'Navigate to Settings > API Keys',
88			'Generate a new API key',
89			'Store the key as COMPOSIO_API_KEY',
90		],
91	},
92});