@w3kits-com/plugin-opendesign 0.1.8 → 0.1.10

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/connectors/composio.js

@@ -0,0 +1,1328 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { defineConnectorTool } from './catalog.js';
+import { deleteComposioAuthConfigId, readComposioConfig, setComposioAuthConfigId } from './composio-config.js';
+import { COMPOSIO_CURATION_OVERLAY } from './composio-curation.js';
+import { getComposioToolkitMetadata } from './composio-descriptions.js';
+import { ConnectorServiceError } from './service.js';
+const DEFAULT_COMPOSIO_BASE_URL = 'https://backend.composio.dev';
+const DEFAULT_COMPOSIO_TIMEOUT_MS = 30_000;
+const DEFAULT_COMPOSIO_USER_ID = 'open-design-local-user';
+const OAUTH_STATE_TTL_MS = 10 * 60 * 1000;
+const DISCOVERY_CACHE_TTL_MS = 60_000;
+const CUSTOM_AUTH_REQUIRED_MESSAGE = 'Composio does not have managed credentials for this toolkit.';
+const PERSISTED_CATALOG_REFRESH_MS = 24 * 60 * 60 * 1000;
+let composioCatalogCacheFilePath = path.join(process.cwd(), '.od', 'connectors', 'composio-catalog-cache.json');
+const FEATURED_COMPOSIO_CATALOG = [
+    {
+        id: 'github',
+        name: 'GitHub',
+        provider: 'composio',
+        category: 'Developer',
+        description: 'Search and inspect GitHub repositories, issues, and pull requests.',
+        providerConnectorId: 'GITHUB',
+        authentication: 'composio',
+        tools: [
+            defineConnectorTool({
+                name: 'github.github_search_repositories',
+                providerToolId: 'GITHUB_SEARCH_REPOSITORIES',
+                title: 'Search repositories',
+                description: 'Search public and private repositories.',
+                inputSchemaJson: { type: 'object', properties: { query: { type: 'string' } }, required: ['query'], additionalProperties: false },
+                outputSchemaJson: { type: 'object', additionalProperties: true },
+                requiredScopes: ['read'],
+            }),
+            defineConnectorTool({
+                name: 'github.github_get_issue',
+                providerToolId: 'GITHUB_GET_ISSUE',
+                title: 'Get issue',
+                description: 'Read a GitHub issue by owner, repository, and issue number.',
+                inputSchemaJson: { type: 'object', properties: { owner: { type: 'string' }, repo: { type: 'string' }, issue_number: { type: 'number' } }, required: ['owner', 'repo', 'issue_number'], additionalProperties: false },
+                outputSchemaJson: { type: 'object', additionalProperties: true },
+                requiredScopes: ['issues:read'],
+            }),
+        ],
+        allowedToolNames: ['github.github_search_repositories', 'github.github_get_issue'],
+        featuredToolNames: ['github.github_search_repositories', 'github.github_get_issue'],
+        minimumApproval: 'auto',
+        toolCount: 2,
+    },
+    {
+        id: 'notion',
+        name: 'Notion',
+        provider: 'composio',
+        category: 'Productivity',
+        description: 'Search and read Notion pages and databases.',
+        providerConnectorId: 'NOTION',
+        authentication: 'composio',
+        tools: [
+            defineConnectorTool({
+                name: 'notion.notion_search',
+                providerToolId: 'NOTION_SEARCH',
+                title: 'Search Notion',
+                description: 'Search Notion pages and databases.',
+                inputSchemaJson: { type: 'object', properties: { query: { type: 'string' } }, required: ['query'], additionalProperties: false },
+                outputSchemaJson: { type: 'object', additionalProperties: true },
+                requiredScopes: ['read'],
+            }),
+            defineConnectorTool({
+                name: 'notion.notion_fetch_database',
+                providerToolId: 'NOTION_FETCH_DATABASE',
+                title: 'Fetch database',
+                description: 'Read a Notion database by id.',
+                inputSchemaJson: { type: 'object', properties: { database_id: { type: 'string' } }, required: ['database_id'], additionalProperties: false },
+                outputSchemaJson: { type: 'object', additionalProperties: true },
+                requiredScopes: ['databases:read'],
+            }),
+        ],
+        allowedToolNames: ['notion.notion_search', 'notion.notion_fetch_database'],
+        featuredToolNames: ['notion.notion_search', 'notion.notion_fetch_database'],
+        minimumApproval: 'auto',
+        toolCount: 48,
+    },
+    {
+        id: 'google_drive',
+        name: 'Google Drive',
+        provider: 'composio',
+        category: 'Storage',
+        description: 'Search and read files from Google Drive.',
+        providerConnectorId: 'GOOGLEDRIVE',
+        authentication: 'composio',
+        tools: [
+            defineConnectorTool({
+                name: 'google_drive.googledrive_search',
+                providerToolId: 'GOOGLEDRIVE_SEARCH',
+                title: 'Search Drive',
+                description: 'Search files in Google Drive.',
+                inputSchemaJson: { type: 'object', properties: { query: { type: 'string' } }, required: ['query'], additionalProperties: false },
+                outputSchemaJson: { type: 'object', additionalProperties: true },
+                requiredScopes: ['drive.readonly'],
+            }),
+            defineConnectorTool({
+                name: 'google_drive.googledrive_get_file',
+                providerToolId: 'GOOGLEDRIVE_GET_FILE',
+                title: 'Get file',
+                description: 'Read Google Drive file metadata by id.',
+                inputSchemaJson: { type: 'object', properties: { file_id: { type: 'string' } }, required: ['file_id'], additionalProperties: false },
+                outputSchemaJson: { type: 'object', additionalProperties: true },
+                requiredScopes: ['drive.readonly'],
+            }),
+        ],
+        allowedToolNames: ['google_drive.googledrive_search', 'google_drive.googledrive_get_file'],
+        featuredToolNames: ['google_drive.googledrive_search', 'google_drive.googledrive_get_file'],
+        minimumApproval: 'auto',
+        toolCount: 2,
+    },
+];
+const DOCUMENTED_COMPOSIO_TOOLKITS = [
+    { name: 'Airtable', slug: 'AIRTABLE' },
+    { name: 'Apaleo', slug: 'APALEO' },
+    { name: 'Asana', slug: 'ASANA' },
+    { name: 'Attio', slug: 'ATTIO' },
+    { name: 'Basecamp', slug: 'BASECAMP' },
+    { name: 'Bitbucket', slug: 'BITBUCKET' },
+    { name: 'Blackbaud', slug: 'BLACKBAUD' },
+    { name: 'Boldsign', slug: 'BOLDSIGN' },
+    { name: 'Box', slug: 'BOX' },
+    { name: 'Cal', slug: 'CAL' },
+    { name: 'Calendly', slug: 'CALENDLY' },
+    { name: 'Canva', slug: 'CANVA' },
+    { name: 'Capsule CRM', slug: 'CAPSULE_CRM' },
+    { name: 'ClickUp', slug: 'CLICKUP' },
+    { name: 'Confluence', slug: 'CONFLUENCE' },
+    { name: 'Contentful', slug: 'CONTENTFUL' },
+    { name: 'Convex', slug: 'CONVEX' },
+    { name: 'Crowdin', slug: 'CROWDIN' },
+    { name: 'Dart', slug: 'DART' },
+    { name: 'Dialpad', slug: 'DIALPAD' },
+    { name: 'DigitalOcean', slug: 'DIGITAL_OCEAN' },
+    { name: 'Discord', slug: 'DISCORD' },
+    { name: 'Discord Bot', slug: 'DISCORDBOT' },
+    { name: 'Dropbox', slug: 'DROPBOX' },
+    { name: 'Dub', slug: 'DUB' },
+    { name: 'Dynamics 365', slug: 'DYNAMICS365' },
+    { name: 'Eventbrite', slug: 'EVENTBRITE' },
+    { name: 'Excel', slug: 'EXCEL' },
+    { name: 'Exist', slug: 'EXIST' },
+    { name: 'Facebook', slug: 'FACEBOOK' },
+    { name: 'Fathom', slug: 'FATHOM' },
+    { name: 'Figma', slug: 'FIGMA' },
+    { name: 'Freeagent', slug: 'FREEAGENT' },
+    { name: 'FreshBooks', slug: 'FRESHBOOKS' },
+    { name: 'GitHub', slug: 'GITHUB' },
+    { name: 'GitLab', slug: 'GITLAB' },
+    { name: 'Gmail', slug: 'GMAIL' },
+    { name: 'Google Ads', slug: 'GOOGLEADS' },
+    { name: 'Google Analytics', slug: 'GOOGLE_ANALYTICS' },
+    { name: 'Google BigQuery', slug: 'GOOGLEBIGQUERY' },
+    { name: 'Google Calendar', slug: 'GOOGLECALENDAR' },
+    { name: 'Google Classroom', slug: 'GOOGLE_CLASSROOM' },
+    { name: 'Google Docs', slug: 'GOOGLEDOCS' },
+    { name: 'Google Drive', slug: 'GOOGLEDRIVE' },
+    { name: 'Google Maps', slug: 'GOOGLE_MAPS' },
+    { name: 'Google Meet', slug: 'GOOGLEMEET' },
+    { name: 'Google Photos', slug: 'GOOGLEPHOTOS' },
+    { name: 'Google Search Console', slug: 'GOOGLE_SEARCH_CONSOLE' },
+    { name: 'Google Sheets', slug: 'GOOGLESHEETS' },
+    { name: 'Google Slides', slug: 'GOOGLESLIDES' },
+    { name: 'Google Super', slug: 'GOOGLESUPER' },
+    { name: 'Google Tasks', slug: 'GOOGLETASKS' },
+    { name: 'Gorgias', slug: 'GORGIAS' },
+    { name: 'Gumroad', slug: 'GUMROAD' },
+    { name: 'Harvest', slug: 'HARVEST' },
+    { name: 'HubSpot', slug: 'HUBSPOT' },
+    { name: 'Hugging Face', slug: 'HUGGING_FACE' },
+    { name: 'Instagram', slug: 'INSTAGRAM' },
+    { name: 'Intercom', slug: 'INTERCOM' },
+    { name: 'Jira', slug: 'JIRA' },
+    { name: 'Kit', slug: 'KIT' },
+    { name: 'Linear', slug: 'LINEAR' },
+    { name: 'LinkedIn', slug: 'LINKEDIN' },
+    { name: 'Linkhut', slug: 'LINKHUT' },
+    { name: 'Mailchimp', slug: 'MAILCHIMP' },
+    { name: 'Microsoft Teams', slug: 'MICROSOFT_TEAMS' },
+    { name: 'Miro', slug: 'MIRO' },
+    { name: 'Monday', slug: 'MONDAY' },
+    { name: 'Moneybird', slug: 'MONEYBIRD' },
+    { name: 'Mural', slug: 'MURAL' },
+    { name: 'Notion', slug: 'NOTION' },
+    { name: 'Omnisend', slug: 'OMNISEND' },
+    { name: 'OneDrive', slug: 'ONE_DRIVE' },
+    { name: 'Outlook', slug: 'OUTLOOK' },
+    { name: 'PagerDuty', slug: 'PAGERDUTY' },
+    { name: 'Prisma', slug: 'PRISMA' },
+    { name: 'Productboard', slug: 'PRODUCTBOARD' },
+    { name: 'Pushbullet', slug: 'PUSHBULLET' },
+    { name: 'QuickBooks', slug: 'QUICKBOOKS' },
+    { name: 'Reddit', slug: 'REDDIT' },
+    { name: 'Reddit Ads', slug: 'REDDIT_ADS' },
+    { name: 'Roam', slug: 'ROAM' },
+    { name: 'Salesforce', slug: 'SALESFORCE' },
+    { name: 'Sentry', slug: 'SENTRY' },
+    { name: 'Servicem8', slug: 'SERVICEM8' },
+    { name: 'SharePoint', slug: 'SHARE_POINT' },
+    { name: 'Shippo', slug: 'SHIPPO' },
+    { name: 'Slack', slug: 'SLACK' },
+    { name: 'Slackbot', slug: 'SLACKBOT' },
+    { name: 'Splitwise', slug: 'SPLITWISE' },
+    { name: 'Square', slug: 'SQUARE' },
+    { name: 'Stack Exchange', slug: 'STACK_EXCHANGE' },
+    { name: 'Strava', slug: 'STRAVA' },
+    { name: 'Stripe', slug: 'STRIPE' },
+    { name: 'Supabase', slug: 'SUPABASE' },
+    { name: 'Ticketmaster', slug: 'TICKETMASTER' },
+    { name: 'Ticktick', slug: 'TICKTICK' },
+    { name: 'Timely', slug: 'TIMELY' },
+    { name: 'Todoist', slug: 'TODOIST' },
+    { name: 'Toneden', slug: 'TONEDEN' },
+    { name: 'Trello', slug: 'TRELLO' },
+    { name: 'Typeform', slug: 'TYPEFORM' },
+    { name: 'WakaTime', slug: 'WAKATIME' },
+    { name: 'Webex', slug: 'WEBEX' },
+    { name: 'WhatsApp', slug: 'WHATSAPP' },
+    { name: 'Wrike', slug: 'WRIKE' },
+    { name: 'Yandex', slug: 'YANDEX' },
+    { name: 'YNAB', slug: 'YNAB' },
+    { name: 'YouTube', slug: 'YOUTUBE' },
+    { name: 'Zendesk', slug: 'ZENDESK' },
+    { name: 'Zoho', slug: 'ZOHO' },
+    { name: 'Zoho Bigin', slug: 'ZOHO_BIGIN' },
+    { name: 'Zoho Books', slug: 'ZOHO_BOOKS' },
+    { name: 'Zoho Desk', slug: 'ZOHO_DESK' },
+    { name: 'Zoho Inventory', slug: 'ZOHO_INVENTORY' },
+    { name: 'Zoho Invoice', slug: 'ZOHO_INVOICE' },
+    { name: 'Zoho Mail', slug: 'ZOHO_MAIL' },
+    { name: 'Zoom', slug: 'ZOOM' },
+    { name: 'Apify MCP', slug: 'APIFY_MCP' },
+    { name: 'BambooHR', slug: 'BAMBOOHR' },
+    { name: 'Beeminder', slug: 'BEEMINDER' },
+    { name: 'Bitwarden', slug: 'BITWARDEN' },
+    { name: 'Blackboard', slug: 'BLACKBOARD' },
+    { name: 'Borneo', slug: 'BORNEO' },
+    { name: 'Brevo', slug: 'BREVO' },
+    { name: 'Brex', slug: 'BREX' },
+    { name: 'Canvas', slug: 'CANVAS' },
+    { name: 'Clockify', slug: 'CLOCKIFY' },
+    { name: 'Coupa', slug: 'COUPA' },
+    { name: 'D2L Brightspace', slug: 'D2LBRIGHTSPACE' },
+    { name: 'Databricks', slug: 'DATABRICKS' },
+    { name: 'Datadog', slug: 'DATADOG' },
+    { name: 'DocuSign', slug: 'DOCUSIGN' },
+    { name: 'Dropbox Sign', slug: 'DROPBOX_SIGN' },
+    { name: 'Egnyte', slug: 'EGNYTE' },
+    { name: 'Epic Games', slug: 'EPIC_GAMES' },
+    { name: 'Fly', slug: 'FLY' },
+    { name: 'Follow Up Boss', slug: 'FOLLOW_UP_BOSS' },
+    { name: 'Gong', slug: 'GONG' },
+    { name: 'Google Admin', slug: 'GOOGLE_ADMIN' },
+    { name: 'Google Chat', slug: 'GOOGLE_CHAT' },
+    { name: 'Googlecontacts', slug: 'GOOGLECONTACTS' },
+    { name: 'Googleforms', slug: 'GOOGLEFORMS' },
+    { name: 'Granola MCP', slug: 'GRANOLA_MCP' },
+    { name: 'Gusto', slug: 'GUSTO' },
+    { name: 'Help Scout', slug: 'HELP_SCOUT' },
+    { name: 'Highlevel', slug: 'HIGHLEVEL' },
+    { name: 'Insighto.ai', slug: 'INSIGHTO_AI' },
+    { name: 'Klaviyo', slug: 'KLAVIYO' },
+    { name: 'Kommo', slug: 'KOMMO' },
+    { name: 'Lever', slug: 'LEVER' },
+    { name: 'Linkedin Ads', slug: 'LINKEDIN_ADS' },
+    { name: 'Lodgify', slug: 'LODGIFY' },
+    { name: 'Matterport', slug: 'MATTERPORT' },
+    { name: 'Meta Ads', slug: 'METAADS' },
+    { name: 'Monday MCP', slug: 'MONDAY_MCP' },
+    { name: 'Netsuite', slug: 'NETSUITE' },
+    { name: 'Parma', slug: 'PARMA' },
+    { name: 'Pinecone', slug: 'PINECONE' },
+    { name: 'Pipedrive', slug: 'PIPEDRIVE' },
+    { name: 'Ramp', slug: 'RAMP' },
+    { name: 'Razorpay', slug: 'RAZORPAY' },
+    { name: 'Recruitee', slug: 'RECRUITEE' },
+    { name: 'Salesforce Service Cloud', slug: 'SALESFORCE_SERVICE_CLOUD' },
+    { name: 'Scheduleonce', slug: 'SCHEDULEONCE' },
+    { name: 'Sendloop', slug: 'SENDLOOP' },
+    { name: 'ServiceNow', slug: 'SERVICENOW' },
+    { name: 'Shopify', slug: 'SHOPIFY' },
+    { name: 'Snapchat', slug: 'SNAPCHAT' },
+    { name: 'Snowflake', slug: 'SNOWFLAKE' },
+    { name: 'Spotify', slug: 'SPOTIFY' },
+    { name: 'Storyblok', slug: 'STORYBLOK' },
+    { name: 'SurveyMonkey', slug: 'SURVEY_MONKEY' },
+    { name: 'Tally', slug: 'TALLY' },
+    { name: 'Tavily MCP', slug: 'TAVILY_MCP' },
+    { name: 'Tiktok', slug: 'TIKTOK' },
+    { name: 'TinyFish MCP', slug: 'TINYFISH_MCP' },
+    { name: 'Twitter', slug: 'TWITTER' },
+    { name: 'Webflow', slug: 'WEBFLOW' },
+    { name: 'Xero', slug: 'XERO' },
+    { name: 'Zoominfo', slug: 'ZOOMINFO' },
+];
+const STATIC_COMPOSIO_CATALOG = buildStaticComposioCatalog();
+export class ComposioConnectorProvider {
+    discoveredAuthConfigIds;
+    locallyCreatedAuthConfigs = new Map();
+    definitionsCache = new Map();
+    definitionsPromises = new Map();
+    definitionsGeneration = 0;
+    authConfigCreationPromises = new Map();
+    unsupportedManagedAuthConfigs = new Map();
+    pendingConnections = new Map();
+    persistedDefinitions;
+    persistedFetchedAt;
+    refreshTimer;
+    refreshTimeout;
+    isConfigured(definition) {
+        return Boolean(this.getApiKey() && (this.getPersistedAuthConfigId(definition.id) || this.discoveredAuthConfigIds?.[definition.id]));
+    }
+    clearDiscoveryCache() {
+        this.discoveredAuthConfigIds = undefined;
+        this.locallyCreatedAuthConfigs.clear();
+        this.invalidateDefinitionsCache();
+        this.authConfigCreationPromises.clear();
+        this.unsupportedManagedAuthConfigs.clear();
+    }
+    configureCatalogCache(dataDir) {
+        composioCatalogCacheFilePath = path.join(dataDir, 'connectors', 'composio-catalog-cache.json');
+        this.loadPersistedCatalogCache();
+    }
+    startCatalogRefreshLoop() {
+        this.stopCatalogRefreshLoop();
+        if (this.isPersistedCatalogStale())
+            this.scheduleCatalogRefresh(0);
+        this.refreshTimer = setInterval(() => {
+            void this.refreshCatalogInBackground();
+        }, PERSISTED_CATALOG_REFRESH_MS);
+        this.refreshTimer.unref?.();
+    }
+    stopCatalogRefreshLoop() {
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+            this.refreshTimer = undefined;
+        }
+        if (this.refreshTimeout) {
+            clearTimeout(this.refreshTimeout);
+            this.refreshTimeout = undefined;
+        }
+    }
+    getFastDefinitions() {
+        return this.persistedDefinitions && this.persistedDefinitions.length > 0
+            ? this.persistedDefinitions
+            : getStaticComposioCatalogDefinitions();
+    }
+    getPersistedCatalogMetadata() {
+        return {
+            ...(this.persistedFetchedAt === undefined ? {} : { fetchedAt: this.persistedFetchedAt }),
+            stale: this.isPersistedCatalogStale(),
+        };
+    }
+    async refreshCatalog(signal) {
+        this.invalidateDefinitionsCache();
+        const definitions = await this.listDefinitions(signal);
+        this.setPersistedDefinitions(definitions, new Date().toISOString());
+        return definitions;
+    }
+    invalidateDefinitionsCache() {
+        this.definitionsGeneration += 1;
+        this.definitionsCache.clear();
+        this.definitionsPromises.clear();
+    }
+    async listDefinitions(signal, options = {}) {
+        const cacheKey = options.hydrateTools ? 'hydrated' : 'metadata';
+        const now = Date.now();
+        const cached = this.definitionsCache.get(cacheKey);
+        if (cached && cached.expiresAtMs > now) {
+            return cached.definitions;
+        }
+        const existing = this.definitionsPromises.get(cacheKey);
+        if (existing)
+            return existing;
+        const generation = this.definitionsGeneration;
+        const promise = this.fetchDefinitions(signal, Boolean(options.hydrateTools))
+            .then((definitions) => {
+            if (this.definitionsGeneration === generation) {
+                this.definitionsCache.set(cacheKey, { definitions, expiresAtMs: Date.now() + DISCOVERY_CACHE_TTL_MS });
+            }
+            this.setPersistedDefinitions(definitions, new Date().toISOString());
+            return definitions;
+        })
+            .finally(() => {
+            if (this.definitionsPromises.get(cacheKey) === promise && this.definitionsGeneration === generation)
+                this.definitionsPromises.delete(cacheKey);
+        });
+        this.definitionsPromises.set(cacheKey, promise);
+        return promise;
+    }
+    async fetchDefinitions(signal, hydrateTools = false) {
+        const apiKey = this.getApiKey();
+        const authConfigs = apiKey ? await this.listAuthConfigsSafe(signal) : [];
+        const configuredByConnectorId = new Map();
+        const discoveredAuthConfigIds = {};
+        for (const item of authConfigs) {
+            const authConfigId = getComposioAuthConfigId(item);
+            const toolkitSlug = getComposioToolkitSlug(item);
+            const status = getString(item.status)?.toUpperCase();
+            if (!authConfigId || !toolkitSlug || (status && status !== 'ENABLED'))
+                continue;
+            const connectorId = connectorIdForToolkitSlug(toolkitSlug);
+            discoveredAuthConfigIds[connectorId] = authConfigId;
+            if (!configuredByConnectorId.has(connectorId))
+                configuredByConnectorId.set(connectorId, { authConfigId, toolkitSlug });
+        }
+        for (const [connectorId, local] of this.locallyCreatedAuthConfigs) {
+            discoveredAuthConfigIds[connectorId] = local.authConfigId;
+            if (!configuredByConnectorId.has(connectorId))
+                configuredByConnectorId.set(connectorId, local);
+        }
+        this.discoveredAuthConfigIds = discoveredAuthConfigIds;
+        const toolkits = apiKey ? await this.listToolkitsSafe(signal) : [];
+        const toolkitBySlug = new Map(toolkits.map((toolkit) => [normalizeComposioSlug(getString(toolkit.slug) ?? ''), toolkit]));
+        const definitions = await mapWithConcurrency(STATIC_COMPOSIO_CATALOG, 8, async (staticDefinition) => {
+            const configuredEntry = configuredByConnectorId.get(staticDefinition.id);
+            const toolkitSlug = configuredEntry?.toolkitSlug ?? staticDefinition.providerConnectorId ?? staticDefinition.id;
+            const toolkit = toolkitBySlug.get(normalizeComposioSlug(toolkitSlug));
+            return this.definitionFromToolkit(staticDefinition, toolkitSlug, toolkit, Boolean(apiKey && hydrateTools), signal);
+        });
+        return definitions;
+    }
+    scheduleCatalogRefresh(delayMs) {
+        if (this.refreshTimeout)
+            clearTimeout(this.refreshTimeout);
+        const timeout = setTimeout(() => {
+            if (this.refreshTimeout === timeout)
+                this.refreshTimeout = undefined;
+            void this.refreshCatalogInBackground();
+        }, delayMs);
+        this.refreshTimeout = timeout;
+        timeout.unref?.();
+    }
+    async refreshCatalogInBackground() {
+        if (!this.getApiKey())
+            return;
+        try {
+            await this.refreshCatalog();
+        }
+        catch {
+            // Keep startup and background refresh best-effort only.
+        }
+    }
+    isPersistedCatalogStale(now = Date.now()) {
+        if (!this.persistedFetchedAt)
+            return true;
+        const fetchedAtMs = Date.parse(this.persistedFetchedAt);
+        return !Number.isFinite(fetchedAtMs) || now - fetchedAtMs >= PERSISTED_CATALOG_REFRESH_MS;
+    }
+    loadPersistedCatalogCache() {
+        const parsed = readPersistedComposioCatalogCache(composioCatalogCacheFilePath);
+        if (!parsed) {
+            this.persistedDefinitions = undefined;
+            this.persistedFetchedAt = undefined;
+            return;
+        }
+        this.persistedDefinitions = parsed.definitions.map((definition) => cloneConnectorDefinition(definition));
+        this.persistedFetchedAt = parsed.fetchedAt;
+        if (this.isPersistedCatalogStale() && this.getApiKey())
+            this.scheduleCatalogRefresh(0);
+    }
+    setPersistedDefinitions(definitions, fetchedAt) {
+        this.persistedDefinitions = definitions.map((definition) => cloneConnectorDefinition(definition));
+        this.persistedFetchedAt = fetchedAt;
+        try {
+            writePersistedComposioCatalogCache(composioCatalogCacheFilePath, {
+                schemaVersion: 1,
+                fetchedAt,
+                provider: 'composio',
+                definitions: this.persistedDefinitions,
+            });
+        }
+        catch (error) {
+            console.warn('[connectors] Failed to persist Composio catalog cache:', error);
+        }
+    }
+    async getDefinition(connectorId, signal) {
+        const discovered = (await this.listDefinitions(signal)).find((definition) => definition.id === connectorId);
+        if (discovered)
+            return discovered;
+        return undefined;
+    }
+    async getHydratedDefinition(connectorId, signal) {
+        const discovered = (await this.listDefinitions(signal, { hydrateTools: true })).find((definition) => definition.id === connectorId);
+        if (discovered)
+            return discovered;
+        return undefined;
+    }
+    async getPreviewDefinition(connectorId, options) {
+        const metadataDefinition = (await this.listDefinitions(options.signal)).find((definition) => definition.id === connectorId);
+        if (!metadataDefinition)
+            return undefined;
+        const toolkitSlug = metadataDefinition.providerConnectorId ?? metadataDefinition.id;
+        return this.definitionFromToolkit(metadataDefinition, toolkitSlug, undefined, true, options.signal, {
+            toolsLimit: options.toolsLimit,
+            ...(options.toolsCursor === undefined ? {} : { toolsCursor: options.toolsCursor }),
+        });
+    }
+    async connect(definition, callbackUrl, signal) {
+        this.pruneExpiredPendingConnections();
+        let authConfig = await this.getOrCreateManagedAuthConfigId(definition, signal);
+        const state = crypto.randomBytes(24).toString('base64url');
+        const expiresAtMs = Date.now() + OAUTH_STATE_TTL_MS;
+        const expiresAt = new Date(expiresAtMs).toISOString();
+        const callbackUrlWithState = appendOAuthStateToCallbackUrl(callbackUrl, state);
+        let response;
+        try {
+            response = await this.createConnectedAccountLink(authConfig.authConfigId, state, callbackUrlWithState, signal);
+        }
+        catch (error) {
+            if (!authConfig.fromCache)
+                throw error;
+            deleteComposioAuthConfigId(definition.id);
+            authConfig = await this.getOrCreateManagedAuthConfigId(definition, signal, { ignoreCache: true });
+            response = await this.createConnectedAccountLink(authConfig.authConfigId, state, callbackUrlWithState, signal);
+        }
+        const providerConnectionId = getComposioConnectionId(response);
+        const redirectUrl = getString(response.redirect_url) ?? getString(response.redirectUrl);
+        const status = getString(response.status)?.toUpperCase();
+        this.pendingConnections.set(state, { connectorId: definition.id, state, ...(providerConnectionId ? { providerConnectionId } : {}), expiresAtMs });
+        const validatedConnection = status === 'ACTIVE' && providerConnectionId
+            ? await this.getValidatedConnectedAccount(definition, providerConnectionId, authConfig.authConfigId, signal)
+            : undefined;
+        if (validatedConnection)
+            this.pendingConnections.delete(state);
+        return {
+            kind: redirectUrl ? 'redirect_required' : status === 'ACTIVE' ? 'connected' : 'pending',
+            ...(redirectUrl ? { redirectUrl } : {}),
+            ...(providerConnectionId ? { providerConnectionId } : {}),
+            expiresAt,
+            ...(validatedConnection ? this.connectionToCredentials(definition, providerConnectionId, validatedConnection) : {}),
+        };
+    }
+    async prepareAuthConfig(definition, signal) {
+        if (definition.authentication !== 'composio')
+            return { status: 'error', message: 'connector is not backed by Composio' };
+        const unsupported = this.unsupportedManagedAuthConfigs.get(definition.id);
+        if (unsupported)
+            return { status: 'custom_required', message: unsupported };
+        try {
+            const resolution = await this.getOrCreateManagedAuthConfigId(definition, signal);
+            return { status: 'ready', authConfigId: resolution.authConfigId };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (isCustomAuthRequiredMessage(message)) {
+                const customMessage = normalizeCustomAuthRequiredMessage(message);
+                this.unsupportedManagedAuthConfigs.set(definition.id, customMessage);
+                return { status: 'custom_required', message: customMessage };
+            }
+            return { status: 'error', message };
+        }
+    }
+    cancelPendingConnections(connectorId) {
+        this.pruneExpiredPendingConnections();
+        let cancelled = 0;
+        for (const [state, pending] of this.pendingConnections.entries()) {
+            if (pending.connectorId !== connectorId)
+                continue;
+            this.pendingConnections.delete(state);
+            cancelled += 1;
+        }
+        return cancelled;
+    }
+    async completeConnection(input) {
+        this.pruneExpiredPendingConnections();
+        const connectorId = input.definition.id;
+        const pending = this.pendingConnections.get(input.state);
+        this.pendingConnections.delete(input.state);
+        if (!pending || pending.connectorId !== connectorId || pending.expiresAtMs < Date.now()) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio OAuth state is missing or expired', 400, { connectorId });
+        }
+        if (input.status && input.status.toLowerCase() !== 'success') {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio OAuth did not complete successfully', 400, { connectorId });
+        }
+        const providerConnectionId = input.providerConnectionId ?? pending.providerConnectionId;
+        if (input.providerConnectionId && pending.providerConnectionId && input.providerConnectionId !== pending.providerConnectionId) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio callback connection id did not match pending connection', 403, { connectorId });
+        }
+        if (!providerConnectionId) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio callback did not include a connection id', 400, { connectorId });
+        }
+        const expectedAuthConfigId = await this.getAuthConfigId(input.definition, input.signal);
+        const response = await this.getValidatedConnectedAccount(input.definition, providerConnectionId, expectedAuthConfigId, input.signal);
+        const authConfigId = getString(response.auth_config?.id);
+        if (authConfigId)
+            this.storeAuthConfigId(input.definition, authConfigId, getString(response.toolkit?.slug) ?? input.definition.providerConnectorId);
+        return this.connectionToCredentials(input.definition, providerConnectionId, response);
+    }
+    pruneExpiredPendingConnections(now = Date.now()) {
+        for (const [state, pending] of this.pendingConnections.entries()) {
+            if (pending.expiresAtMs <= now)
+                this.pendingConnections.delete(state);
+        }
+    }
+    async getValidatedConnectedAccount(definition, providerConnectionId, expectedAuthConfigId, signal) {
+        const connectorId = definition.id;
+        const response = await this.requestJson(`/api/v3/connected_accounts/${encodeURIComponent(providerConnectionId)}`, {
+            method: 'GET',
+            ...(signal === undefined ? {} : { signal }),
+        });
+        const providerUserId = getString(response.user_id) ?? getString(response.userId);
+        if (providerUserId && providerUserId !== this.getUserId()) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio account belongs to a different user', 403, { connectorId });
+        }
+        const providerAuthConfigId = getString(response.auth_config?.id);
+        if (expectedAuthConfigId && providerAuthConfigId && expectedAuthConfigId !== providerAuthConfigId) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio account belongs to a different auth configuration', 403, { connectorId, expectedAuthConfigId, providerAuthConfigId });
+        }
+        const expectedToolkitSlug = definition.providerConnectorId;
+        const providerToolkitSlug = getString(response.toolkit?.slug);
+        if (expectedToolkitSlug && providerToolkitSlug && connectorIdForToolkitSlug(expectedToolkitSlug) !== connectorIdForToolkitSlug(providerToolkitSlug)) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio account belongs to a different toolkit', 403, { connectorId });
+        }
+        return response;
+    }
+    async disconnect(credentials, signal) {
+        const providerConnectionId = credentials ? getString(credentials.providerConnectionId) : undefined;
+        if (!providerConnectionId || !this.getApiKey())
+            return;
+        const response = await this.request(`/api/v3/connected_accounts/${encodeURIComponent(providerConnectionId)}`, { method: 'DELETE', ...(signal === undefined ? {} : { signal }) });
+        if (!response.ok && response.status !== 404) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', `Composio disconnect failed with HTTP ${response.status}`, 502, { httpStatus: response.status });
+        }
+    }
+    async execute(definition, tool, input, credentials, signal) {
+        const providerConnectionId = credentials ? getString(credentials.providerConnectionId) : undefined;
+        if (!providerConnectionId) {
+            throw new ConnectorServiceError('CONNECTOR_NOT_CONNECTED', 'Composio connector is not connected', 403, { connectorId: definition.id });
+        }
+        const providerToolId = tool.providerToolId ?? tool.name;
+        const response = await this.requestJson(`/api/v3.1/tools/execute/${encodeURIComponent(providerToolId)}`, {
+            method: 'POST',
+            body: JSON.stringify({
+                connected_account_id: providerConnectionId,
+                user_id: this.getUserId(),
+                arguments: input,
+            }),
+            ...(signal === undefined ? {} : { signal }),
+        });
+        if (response.successful === false || response.error) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio tool execution failed', 502, {
+                connectorId: definition.id,
+                toolName: tool.name,
+                error: toBoundedJsonValue(response.error),
+            });
+        }
+        const output = toBoundedJsonValue(response.data);
+        return {
+            toolName: tool.name,
+            providerToolId,
+            data: output,
+            ...(getString(response.log_id) ?? getString(response.logId) ? { providerExecutionId: (getString(response.log_id) ?? getString(response.logId)) } : {}),
+            ...(toBoundedJsonValue(response.session_info ?? response.sessionInfo) !== null ? { sessionInfo: toBoundedJsonValue(response.session_info ?? response.sessionInfo) } : {}),
+        };
+    }
+    async getAuthConfigId(definition, signal) {
+        const persisted = this.getPersistedAuthConfigId(definition.id);
+        if (persisted)
+            return persisted;
+        if (!this.discoveredAuthConfigIds)
+            this.discoveredAuthConfigIds = await this.discoverAuthConfigIds(signal);
+        return this.discoveredAuthConfigIds[definition.id];
+    }
+    async getOrCreateManagedAuthConfigId(definition, signal, options = {}) {
+        if (!options.ignoreCache) {
+            const persisted = this.getPersistedAuthConfigId(definition.id);
+            if (persisted) {
+                return { authConfigId: persisted, fromCache: true };
+            }
+            const discovered = this.discoveredAuthConfigIds?.[definition.id];
+            if (discovered) {
+                return { authConfigId: discovered, fromCache: true };
+            }
+        }
+        const existing = await this.getAuthConfigIdForToolkit(definition, signal);
+        if (existing) {
+            this.storeAuthConfigId(definition, existing);
+            return { authConfigId: existing, fromCache: false };
+        }
+        const inFlight = this.authConfigCreationPromises.get(definition.id);
+        if (inFlight) {
+            const authConfigId = await inFlight;
+            return { authConfigId, fromCache: false };
+        }
+        const promise = this.createAndStoreManagedAuthConfigId(definition, signal)
+            .finally(() => {
+            if (this.authConfigCreationPromises.get(definition.id) === promise)
+                this.authConfigCreationPromises.delete(definition.id);
+        });
+        this.authConfigCreationPromises.set(definition.id, promise);
+        const authConfigId = await promise;
+        return { authConfigId, fromCache: false };
+    }
+    async createAndStoreManagedAuthConfigId(definition, signal) {
+        const created = await this.createManagedAuthConfig(definition, signal);
+        const authConfigId = getComposioAuthConfigId(created);
+        const toolkitSlug = getComposioToolkitSlug(created) ?? definition.providerConnectorId;
+        if (!authConfigId || !toolkitSlug) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio auth config response was missing an id or toolkit slug', 502, {
+                connectorId: definition.id,
+            });
+        }
+        const connectorId = connectorIdForToolkitSlug(toolkitSlug);
+        if (connectorId !== definition.id) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio created an auth config for a different toolkit', 502, {
+                connectorId: definition.id,
+                toolkitSlug,
+            });
+        }
+        this.storeAuthConfigId(definition, authConfigId, toolkitSlug);
+        this.invalidateDefinitionsCache();
+        return authConfigId;
+    }
+    async createManagedAuthConfig(definition, signal) {
+        const toolkitSlug = definition.providerConnectorId;
+        if (!toolkitSlug) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio connector is missing a toolkit slug', 500, { connectorId: definition.id });
+        }
+        return this.requestJson('/api/v3.1/auth_configs', {
+            method: 'POST',
+            body: JSON.stringify({
+                toolkit: { slug: toolkitSlug },
+                auth_config: { type: 'use_composio_managed_auth' },
+            }),
+            ...(signal === undefined ? {} : { signal }),
+        });
+    }
+    async getAuthConfigIdForToolkit(definition, signal) {
+        const toolkitSlug = definition.providerConnectorId;
+        if (!toolkitSlug) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio connector is missing a toolkit slug', 500, { connectorId: definition.id });
+        }
+        const items = await this.listAuthConfigsSafe(signal, toolkitSlug);
+        for (const item of items) {
+            const authConfigId = getComposioAuthConfigId(item);
+            const itemToolkitSlug = getComposioToolkitSlug(item) ?? toolkitSlug;
+            const status = getString(item.status)?.toUpperCase();
+            if (!authConfigId || (status && status !== 'ENABLED'))
+                continue;
+            if (connectorIdForToolkitSlug(itemToolkitSlug) !== definition.id)
+                continue;
+            return authConfigId;
+        }
+        return undefined;
+    }
+    async createConnectedAccountLink(authConfigId, state, callbackUrl, signal) {
+        return this.requestJson('/api/v3.1/connected_accounts/link', {
+            method: 'POST',
+            body: JSON.stringify({
+                auth_config_id: authConfigId,
+                user_id: this.getUserId(),
+                connection_data: { state_prefix: state },
+                callback_url: callbackUrl,
+            }),
+            ...(signal === undefined ? {} : { signal }),
+        });
+    }
+    getPersistedAuthConfigId(connectorId) {
+        return getString(readComposioConfig().authConfigIds[connectorId]);
+    }
+    storeAuthConfigId(definition, authConfigId, toolkitSlug = definition.providerConnectorId) {
+        this.discoveredAuthConfigIds = {
+            ...(this.discoveredAuthConfigIds ?? {}),
+            [definition.id]: authConfigId,
+        };
+        if (toolkitSlug)
+            this.locallyCreatedAuthConfigs.set(definition.id, { authConfigId, toolkitSlug });
+        setComposioAuthConfigId(definition.id, authConfigId);
+    }
+    async discoverAuthConfigIds(signal) {
+        if (!this.getApiKey())
+            return {};
+        const items = await this.listAuthConfigsSafe(signal);
+        const discovered = {};
+        for (const item of items) {
+            const authConfigId = getComposioAuthConfigId(item);
+            const toolkitSlug = getComposioToolkitSlug(item);
+            const status = getString(item.status)?.toUpperCase();
+            if (!authConfigId || !toolkitSlug || (status && status !== 'ENABLED'))
+                continue;
+            discovered[connectorIdForToolkitSlug(toolkitSlug)] = authConfigId;
+        }
+        for (const [connectorId, local] of this.locallyCreatedAuthConfigs)
+            discovered[connectorId] = local.authConfigId;
+        return discovered;
+    }
+    async listAuthConfigs(signal, toolkitSlug) {
+        const path = toolkitSlug
+            ? `/api/v3/auth_configs?${new URLSearchParams({ toolkit_slug: toolkitSlug }).toString()}`
+            : '/api/v3/auth_configs';
+        const response = await this.request(path, { method: 'GET', ...(signal === undefined ? {} : { signal }) });
+        if (!response.ok)
+            return [];
+        const payload = await response.json();
+        const items = Array.isArray(payload.items) ? payload.items : Array.isArray(payload.data) ? payload.data : [];
+        return items.filter((item) => Boolean(item && typeof item === 'object' && !Array.isArray(item)));
+    }
+    async listAuthConfigsSafe(signal, toolkitSlug) {
+        try {
+            return await this.listAuthConfigs(signal, toolkitSlug);
+        }
+        catch {
+            return [];
+        }
+    }
+    async listToolkits(signal) {
+        const response = await this.request('/api/v3.1/toolkits?limit=1000', { method: 'GET', ...(signal === undefined ? {} : { signal }) });
+        if (!response.ok)
+            return [];
+        const payload = await response.json();
+        const items = Array.isArray(payload.items) ? payload.items : Array.isArray(payload.data) ? payload.data : [];
+        return items.filter((item) => Boolean(item && typeof item === 'object' && !Array.isArray(item)));
+    }
+    async listToolkitsSafe(signal) {
+        try {
+            return await this.listToolkits(signal);
+        }
+        catch {
+            return [];
+        }
+    }
+    async listToolsPage(toolkitSlug, options = {}) {
+        const searchParams = new URLSearchParams({ toolkit_slug: toolkitSlug.toLowerCase(), limit: String(options.limit ?? 1000) });
+        if (options.cursor)
+            searchParams.set('cursor', options.cursor);
+        const response = await this.request(`/api/v3.1/tools?${searchParams.toString()}`, { method: 'GET', ...(options.signal === undefined ? {} : { signal: options.signal }) });
+        if (!response.ok) {
+            const message = await getComposioErrorMessage(response);
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', message ?? `Composio tools request failed with HTTP ${response.status}`, response.status === 401 ? 401 : 502, { httpStatus: response.status });
+        }
+        const payload = await response.json();
+        const items = Array.isArray(payload.items) ? payload.items : Array.isArray(payload.data) ? payload.data : [];
+        const nextCursor = getString(payload.next_cursor) ?? getString(payload.nextCursor);
+        const totalItems = getNonNegativeInteger(payload.total_items) ?? getNonNegativeInteger(payload.totalItems);
+        return {
+            items: items.filter((item) => Boolean(item && typeof item === 'object' && !Array.isArray(item))),
+            ...(nextCursor === undefined ? {} : { nextCursor }),
+            ...(totalItems === undefined ? {} : { totalItems }),
+        };
+    }
+    async listTools(toolkitSlug, signal) {
+        return (await this.listToolsPage(toolkitSlug, { limit: 1000, ...(signal === undefined ? {} : { signal }) })).items;
+    }
+    async listToolsSafe(toolkitSlug, signal) {
+        try {
+            return await this.listTools(toolkitSlug, signal);
+        }
+        catch {
+            return [];
+        }
+    }
+    async definitionFromToolkit(staticDefinition, toolkitSlug, toolkit, hydrateTools, signal, toolPageOptions = {}) {
+        const connectorId = staticDefinition.id;
+        const toolPage = hydrateTools && toolPageOptions.toolsLimit !== undefined
+            ? await this.listToolsPage(toolkitSlug, {
+                limit: toolPageOptions.toolsLimit,
+                ...(toolPageOptions.toolsCursor === undefined ? {} : { cursor: toolPageOptions.toolsCursor }),
+                ...(signal === undefined ? {} : { signal }),
+            })
+            : undefined;
+        const liveTools = hydrateTools
+            ? (toolPage?.items ?? await this.listToolsSafe(toolkitSlug, signal))
+                .filter((tool) => {
+                const toolToolkitSlug = getString(tool.toolkit?.slug);
+                return !toolToolkitSlug || normalizeComposioSlug(toolToolkitSlug) === normalizeComposioSlug(toolkitSlug);
+            })
+                .map((tool) => this.toolDefinitionFromComposioTool(connectorId, tool))
+            : [];
+        const liveToolsByName = new Map(liveTools.map((tool) => [tool.name, tool]));
+        const staticToolNames = new Set(staticDefinition.tools.map((tool) => tool.name));
+        const tools = [
+            ...staticDefinition.tools.map((tool) => mergeToolDefinition(tool, liveToolsByName.get(tool.name))),
+            ...liveTools.filter((tool) => !staticToolNames.has(tool.name)),
+        ];
+        const autoAllowedLiveToolNames = liveTools
+            .filter((tool) => tool.refreshEligible)
+            .map((tool) => tool.name);
+        const allowedToolNames = [...new Set([...staticDefinition.allowedToolNames, ...autoAllowedLiveToolNames])];
+        // `curatedToolNames` mirrors the static catalog ONLY — it
+        // intentionally never picks up `autoAllowedLiveToolNames`. It
+        // preserves the static catalog baseline, while summary badges use
+        // `toolCount` when present to reflect the advertised provider
+        // inventory. The execution-time gate keeps using
+        // `allowedToolNames`, so the dynamic auto-allow behavior is
+        // preserved end-to-end.
+        const curatedToolNames = [...staticDefinition.allowedToolNames];
+        const name = getString(toolkit?.name) ?? staticDefinition.name;
+        const category = firstCategoryName(toolkit?.meta?.categories) ?? firstCategoryName(toolkit?.categories) ?? staticDefinition.category;
+        const liveDescription = getComposioToolkitDescription(toolkit);
+        const description = liveDescription ?? staticDefinition.description;
+        const liveToolCount = getComposioToolkitToolCount(toolkit);
+        const toolCount = toolPage?.totalItems ?? liveToolCount ?? staticDefinition.toolCount ?? (tools.length > 0 ? tools.length : undefined);
+        return {
+            ...staticDefinition,
+            id: connectorId,
+            name,
+            providerConnectorId: staticDefinition.providerConnectorId ?? toolkitSlug,
+            category,
+            ...(description === undefined ? {} : { description }),
+            tools,
+            ...(toolCount === undefined ? {} : { toolCount }),
+            ...(toolPage?.nextCursor === undefined ? {} : { toolsNextCursor: toolPage.nextCursor }),
+            ...(toolPage === undefined ? {} : { toolsHasMore: toolPage.nextCursor !== undefined }),
+            allowedToolNames,
+            curatedToolNames,
+            ...(staticDefinition.featuredToolNames === undefined
+                ? tools.length > 0 ? { featuredToolNames: tools.slice(0, 3).map((tool) => tool.name) } : {}
+                : { featuredToolNames: staticDefinition.featuredToolNames }),
+        };
+    }
+    toolDefinitionFromComposioTool(connectorId, tool) {
+        const providerToolId = getString(tool.slug) ?? getString(tool.name) ?? `${connectorId.toUpperCase()}_TOOL`;
+        const description = getString(tool.description) ?? getString(tool.human_description) ?? getString(tool.humanDescription) ?? '';
+        const requiredScopes = getStringArray(tool.scopes ?? tool.oauth_scopes ?? tool.oauthScopes ?? tool.auth_scopes ?? tool.authScopes ?? tool.tags);
+        return applyComposioToolCuration(defineConnectorTool({
+            name: `${connectorId}.${normalizeToolName(providerToolId)}`,
+            providerToolId,
+            title: getString(tool.name) ?? titleFromSlug(providerToolId),
+            ...(description ? { description } : {}),
+            inputSchemaJson: toBoundedJsonObject(tool.input_parameters ?? tool.inputParameters) ?? { type: 'object', additionalProperties: true },
+            outputSchemaJson: { type: 'object', additionalProperties: true },
+            requiredScopes,
+        }), connectorId, providerToolId);
+    }
+    connectionToCredentials(_definition, providerConnectionId, response) {
+        const accountLabel = getString(response.account_label)
+            ?? getString(response.accountLabel)
+            ?? getString(response.email)
+            ?? getString(response.name)
+            ?? providerConnectionId;
+        const accountId = getString(response.account_id) ?? getString(response.accountId);
+        return {
+            connectorId: _definition.id,
+            accountLabel,
+            credentials: {
+                provider: 'composio',
+                providerConnectionId,
+                ...(accountId ? { accountId } : {}),
+            },
+        };
+    }
+    async requestJson(path, input) {
+        const response = await this.request(path, input);
+        if (!response.ok) {
+            const message = await getComposioErrorMessage(response);
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', message ?? `Composio request failed with HTTP ${response.status}`, response.status === 401 ? 401 : 502, { httpStatus: response.status });
+        }
+        const value = await response.json();
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio returned an invalid response', 502);
+        }
+        return value;
+    }
+    async request(path, input) {
+        const apiKey = this.getApiKey();
+        if (!apiKey) {
+            throw new ConnectorServiceError('CONNECTOR_EXECUTION_FAILED', 'Composio provider is not configured', 503, { setting: 'apiKey' });
+        }
+        const timeout = AbortSignal.timeout(DEFAULT_COMPOSIO_TIMEOUT_MS);
+        const signal = input.signal ? AbortSignal.any([input.signal, timeout]) : timeout;
+        return fetch(`${this.getBaseUrl().replace(/\/+$/, '')}${path}`, {
+            method: input.method,
+            headers: {
+                accept: 'application/json',
+                'content-type': 'application/json',
+                'user-agent': 'OpenDesign/0.1 ComposioConnectorProvider',
+                'x-api-key': apiKey,
+            },
+            ...(input.body ? { body: input.body } : {}),
+            signal,
+        });
+    }
+    getApiKey() {
+        return readComposioConfig().apiKey || undefined;
+    }
+    getBaseUrl() {
+        return DEFAULT_COMPOSIO_BASE_URL;
+    }
+    getUserId() {
+        return DEFAULT_COMPOSIO_USER_ID;
+    }
+}
+function mergeToolDefinition(staticTool, liveTool) {
+    if (!liveTool)
+        return staticTool;
+    return {
+        ...staticTool,
+        ...(liveTool.description === undefined ? {} : { description: liveTool.description }),
+        ...(liveTool.inputSchemaJson === undefined ? {} : { inputSchemaJson: liveTool.inputSchemaJson }),
+        ...(liveTool.outputSchemaJson === undefined ? {} : { outputSchemaJson: liveTool.outputSchemaJson }),
+        ...(liveTool.providerToolId === undefined ? {} : { providerToolId: liveTool.providerToolId }),
+        requiredScopes: liveTool.requiredScopes.length > 0 ? liveTool.requiredScopes : staticTool.requiredScopes,
+        safety: liveTool.safety,
+        refreshEligible: liveTool.refreshEligible,
+        ...((liveTool.curation ?? staticTool.curation) === undefined ? {} : { curation: liveTool.curation ?? staticTool.curation }),
+    };
+}
+export const composioConnectorProvider = new ComposioConnectorProvider();
+function buildStaticComposioCatalog() {
+    const definitions = new Map();
+    for (const definition of FEATURED_COMPOSIO_CATALOG) {
+        definitions.set(definition.id, {
+            ...definition,
+            tools: definition.tools.map((tool) => applyComposioToolCuration(tool, definition.providerConnectorId ?? definition.id, tool.providerToolId)),
+        });
+    }
+    for (const toolkit of DOCUMENTED_COMPOSIO_TOOLKITS) {
+        const id = connectorIdForToolkitSlug(toolkit.slug);
+        if (definitions.has(id))
+            continue;
+        definitions.set(id, createComposioCatalogDefinition(toolkit));
+    }
+    return [...definitions.values()];
+}
+function createComposioCatalogDefinition(toolkit) {
+    const curated = getComposioToolkitMetadata(toolkit.slug);
+    // Prefer a hand-authored description when offline. Live Composio toolkit
+    // metadata still wins during discovery, as long as it is not the legacy
+    // generic "Connect to X through Composio." placeholder.
+    const description = curated?.description ?? fallbackComposioDescription(toolkit.name, curated?.category ?? toolkit.category);
+    const category = curated?.category ?? toolkit.category ?? 'Integration';
+    return {
+        id: connectorIdForToolkitSlug(toolkit.slug),
+        name: toolkit.name,
+        provider: 'composio',
+        category,
+        description,
+        providerConnectorId: toolkit.slug,
+        authentication: 'composio',
+        tools: [],
+        allowedToolNames: [],
+        minimumApproval: 'auto',
+        ...(curated?.toolCount === undefined ? {} : { toolCount: curated.toolCount }),
+    };
+}
+export function getStaticComposioCatalogDefinitions() {
+    return STATIC_COMPOSIO_CATALOG.map((definition) => ({
+        ...cloneConnectorDefinition(definition),
+    }));
+}
+function cloneConnectorDefinition(definition) {
+    return {
+        ...definition,
+        tools: definition.tools.map((tool) => ({
+            name: tool.name,
+            title: tool.title,
+            ...(tool.description === undefined ? {} : { description: tool.description }),
+            ...(tool.inputSchemaJson === undefined ? {} : { inputSchemaJson: toBoundedJsonObject(tool.inputSchemaJson) }),
+            ...(tool.outputSchemaJson === undefined ? {} : { outputSchemaJson: toBoundedJsonObject(tool.outputSchemaJson) }),
+            safety: { ...tool.safety },
+            refreshEligible: tool.refreshEligible,
+            ...(tool.curation === undefined ? {} : { curation: { ...(tool.curation.useCases === undefined ? {} : { useCases: [...tool.curation.useCases] }), ...(tool.curation.reason === undefined ? {} : { reason: tool.curation.reason }) } }),
+            requiredScopes: [...tool.requiredScopes],
+            ...(tool.providerToolId === undefined ? {} : { providerToolId: tool.providerToolId }),
+        })),
+        allowedToolNames: [...definition.allowedToolNames],
+        ...(definition.toolCount === undefined ? {} : { toolCount: definition.toolCount }),
+        ...(definition.featuredToolNames === undefined ? {} : { featuredToolNames: [...definition.featuredToolNames] }),
+    };
+}
+function normalizePersistedConnectorDefinition(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const record = value;
+    if (typeof record.id !== 'string' || typeof record.name !== 'string' || typeof record.provider !== 'string' || typeof record.category !== 'string')
+        return undefined;
+    const tools = Array.isArray(record.tools)
+        ? record.tools.map(normalizePersistedConnectorToolDefinition).filter((tool) => tool !== undefined)
+        : [];
+    const definition = {
+        id: record.id,
+        name: record.name,
+        provider: record.provider,
+        category: record.category,
+        tools,
+        allowedToolNames: Array.isArray(record.allowedToolNames) ? record.allowedToolNames.filter((item) => typeof item === 'string') : [],
+    };
+    if (typeof record.description === 'string')
+        definition.description = record.description;
+    if (record.authentication === 'local' || record.authentication === 'none' || record.authentication === 'oauth' || record.authentication === 'composio') {
+        definition.authentication = record.authentication;
+    }
+    if (typeof record.providerConnectorId === 'string')
+        definition.providerConnectorId = record.providerConnectorId;
+    if (Array.isArray(record.featuredToolNames))
+        definition.featuredToolNames = record.featuredToolNames.filter((item) => typeof item === 'string');
+    if (typeof record.toolCount === 'number' && Number.isFinite(record.toolCount) && record.toolCount >= 0) {
+        definition.toolCount = record.toolCount;
+    }
+    if (record.minimumApproval === 'auto' || record.minimumApproval === 'confirm' || record.minimumApproval === 'disabled') {
+        definition.minimumApproval = record.minimumApproval;
+    }
+    if (typeof record.disabled === 'boolean')
+        definition.disabled = record.disabled;
+    return definition;
+}
+function normalizePersistedConnectorToolDefinition(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const record = value;
+    if (typeof record.name !== 'string' || typeof record.title !== 'string')
+        return undefined;
+    if (!record.safety || typeof record.safety !== 'object' || Array.isArray(record.safety))
+        return undefined;
+    const safetyRecord = record.safety;
+    if (typeof safetyRecord.sideEffect !== 'string' || typeof safetyRecord.approval !== 'string' || typeof safetyRecord.reason !== 'string')
+        return undefined;
+    return {
+        name: record.name,
+        title: record.title,
+        ...(typeof record.description === 'string' ? { description: record.description } : {}),
+        ...(toBoundedJsonObject(record.inputSchemaJson) === undefined ? {} : { inputSchemaJson: toBoundedJsonObject(record.inputSchemaJson) }),
+        ...(toBoundedJsonObject(record.outputSchemaJson) === undefined ? {} : { outputSchemaJson: toBoundedJsonObject(record.outputSchemaJson) }),
+        safety: {
+            sideEffect: safetyRecord.sideEffect,
+            approval: safetyRecord.approval,
+            reason: safetyRecord.reason,
+        },
+        refreshEligible: Boolean(record.refreshEligible),
+        ...(record.curation && typeof record.curation === 'object' && !Array.isArray(record.curation)
+            ? {
+                curation: {
+                    ...((record.curation.useCases && Array.isArray(record.curation.useCases))
+                        ? { useCases: record.curation.useCases.filter((item) => item === 'personal_daily_digest') }
+                        : {}),
+                    ...(typeof record.curation.reason === 'string' ? { reason: record.curation.reason } : {}),
+                },
+            }
+            : {}),
+        requiredScopes: Array.isArray(record.requiredScopes) ? record.requiredScopes.filter((item) => typeof item === 'string') : [],
+        ...(typeof record.providerToolId === 'string' ? { providerToolId: record.providerToolId } : {}),
+    };
+}
+function readPersistedComposioCatalogCache(filePath) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            return undefined;
+        const record = parsed;
+        if (record.schemaVersion !== 1 || record.provider !== 'composio' || typeof record.fetchedAt !== 'string' || !Array.isArray(record.definitions))
+            return undefined;
+        return {
+            schemaVersion: 1,
+            provider: 'composio',
+            fetchedAt: record.fetchedAt,
+            definitions: record.definitions.map(normalizePersistedConnectorDefinition).filter((definition) => definition !== undefined),
+        };
+    }
+    catch (error) {
+        if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT')
+            return undefined;
+        return undefined;
+    }
+}
+function writePersistedComposioCatalogCache(filePath, cache) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true, mode: 0o700 });
+    const tempPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+    fs.writeFileSync(tempPath, `${JSON.stringify(cache, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
+    fs.renameSync(tempPath, filePath);
+    fs.chmodSync(filePath, 0o600);
+}
+function getString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+function getNonNegativeInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 0 ? value : undefined;
+}
+function getStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => typeof item === 'string' && item.trim().length > 0).map((item) => item.trim());
+}
+async function mapWithConcurrency(items, concurrency, mapper) {
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    const workerCount = Math.min(Math.max(1, concurrency), items.length);
+    await Promise.all(Array.from({ length: workerCount }, async () => {
+        while (nextIndex < items.length) {
+            const index = nextIndex;
+            nextIndex += 1;
+            results[index] = await mapper(items[index], index);
+        }
+    }));
+    return results;
+}
+function getComposioToolkitDescription(toolkit) {
+    const description = getString(toolkit?.meta?.description) ?? getString(toolkit?.description);
+    if (!description || isGenericComposioDescription(description))
+        return undefined;
+    return description;
+}
+function getComposioToolkitToolCount(toolkit) {
+    return getNonNegativeInteger(toolkit?.meta?.tools_count) ?? getNonNegativeInteger(toolkit?.meta?.toolsCount);
+}
+function isGenericComposioDescription(description) {
+    return /^connect to .+ through composio\.?$/i.test(description.trim())
+        || /^.+ integration via composio\.?$/i.test(description.trim());
+}
+function fallbackComposioDescription(name, category) {
+    const normalizedCategory = category?.trim().toLowerCase();
+    if (normalizedCategory?.includes('project'))
+        return `Coordinate ${name} projects, tasks, and workflow data inside Open Design.`;
+    if (normalizedCategory?.includes('communication'))
+        return `Bring ${name} conversations, channels, and collaboration context into Open Design.`;
+    if (normalizedCategory?.includes('documentation'))
+        return `Search and reuse ${name} knowledge, pages, and documentation in Open Design.`;
+    if (normalizedCategory?.includes('storage'))
+        return `Find and reference ${name} files, folders, and document metadata from Open Design.`;
+    if (normalizedCategory?.includes('developer'))
+        return `Inspect ${name} developer resources, activity, and operational context from Open Design.`;
+    if (normalizedCategory?.includes('crm') || normalizedCategory?.includes('sales'))
+        return `Use ${name} customer, deal, and account context in Open Design artifacts.`;
+    if (normalizedCategory?.includes('marketing'))
+        return `Analyze ${name} campaigns, audiences, and marketing activity from Open Design.`;
+    if (normalizedCategory?.includes('finance') || normalizedCategory?.includes('commerce'))
+        return `Work with ${name} business, billing, and transaction data in Open Design.`;
+    if (normalizedCategory?.includes('observability'))
+        return `Surface ${name} incidents, metrics, and operational signals in Open Design.`;
+    if (normalizedCategory?.includes('data'))
+        return `Query ${name} datasets and platform metadata for data-backed Open Design artifacts.`;
+    return `Use ${name} tools and data directly from Open Design.`;
+}
+function getComposioAuthConfigId(response) {
+    return getString(response.id) ?? getString(response.auth_config?.id);
+}
+function getComposioToolkitSlug(response) {
+    return getString(response.toolkit?.slug) ?? getString(response.toolkit_slug) ?? getString(response.toolkitSlug);
+}
+function getComposioConnectionId(response) {
+    return getString(response.connected_account_id) ?? getString(response.connectedAccountId) ?? getString(response.id) ?? getString(response.nanoid);
+}
+function appendOAuthStateToCallbackUrl(callbackUrl, state) {
+    const url = new URL(callbackUrl);
+    url.searchParams.set('state', state);
+    return url.toString();
+}
+function connectorIdForToolkitSlug(toolkitSlug) {
+    const normalized = normalizeComposioSlug(toolkitSlug);
+    if (normalized === 'googledrive' || normalized === 'gdrive' || normalized === 'drive')
+        return 'google_drive';
+    return normalized;
+}
+function normalizeComposioSlug(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]/g, '');
+}
+function normalizeToolName(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '') || 'tool';
+}
+function normalizeProviderToolId(value) {
+    return normalizeToolName(value);
+}
+function applyComposioToolCuration(tool, connectorId, providerToolId) {
+    const connectorKey = normalizeComposioSlug(connectorId);
+    const overlay = COMPOSIO_CURATION_OVERLAY[connectorKey];
+    const toolKey = providerToolId ? normalizeProviderToolId(providerToolId) : undefined;
+    const curation = toolKey ? overlay?.[toolKey] : undefined;
+    return curation === undefined ? tool : { ...tool, curation: { ...(tool.curation ?? {}), ...curation } };
+}
+function titleFromSlug(value) {
+    return value
+        .replace(/[_-]+/g, ' ')
+        .trim()
+        .replace(/\w\S*/g, (word) => `${word.charAt(0).toUpperCase()}${word.slice(1).toLowerCase()}`);
+}
+function firstCategoryName(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    for (const item of value) {
+        if (typeof item === 'string' && item.trim())
+            return item.trim();
+        if (item && typeof item === 'object' && !Array.isArray(item)) {
+            const record = item;
+            const name = getString(record.name) ?? getString(record.slug);
+            if (name)
+                return name;
+        }
+    }
+    return undefined;
+}
+function isCustomAuthRequiredMessage(message) {
+    return /default auth config not found/i.test(message) || /does not have managed credentials/i.test(message);
+}
+function normalizeCustomAuthRequiredMessage(message) {
+    return message || CUSTOM_AUTH_REQUIRED_MESSAGE;
+}
+async function getComposioErrorMessage(response) {
+    try {
+        const payload = await response.json();
+        if (!payload || typeof payload !== 'object' || Array.isArray(payload))
+            return undefined;
+        const record = payload;
+        const error = record.error && typeof record.error === 'object' && !Array.isArray(record.error)
+            ? record.error
+            : undefined;
+        return getString(record.message)
+            ?? getString(error?.message)
+            ?? getString(record.error)
+            ?? getString(record.detail)
+            ?? getString(error?.suggested_fix);
+    }
+    catch {
+        return undefined;
+    }
+}
+function toBoundedJsonValue(value) {
+    if (value === null || typeof value === 'boolean' || typeof value === 'number' || typeof value === 'string')
+        return value;
+    if (Array.isArray(value))
+        return value.map((item) => toBoundedJsonValue(item));
+    if (value && typeof value === 'object') {
+        const output = {};
+        for (const [key, child] of Object.entries(value))
+            output[key] = toBoundedJsonValue(child);
+        return output;
+    }
+    return null;
+}
+function toBoundedJsonObject(value) {
+    const bounded = toBoundedJsonValue(value);
+    return bounded && typeof bounded === 'object' && !Array.isArray(bounded) ? bounded : undefined;
+}
+//# sourceMappingURL=composio.js.map