integrate-sdk 0.9.27-dev.2 → 0.9.28-dev.0

package/dist/adapters/index.js

@@ -284,6 +284,180 @@ function getContextCookieFromRequest(request) {
 }
 var CONTEXT_COOKIE_NAME = "__integrate_oauth_ctx", CONTEXT_COOKIE_MAX_AGE = 300;
 
+// ../integrations/library-metadata.ts
+function integrationLibraryPresentationFields(integration) {
+  const id = typeof integration["id"] === "string" ? integration["id"] : String(integration["id"] ?? "");
+  const fromCatalog = id ? INTEGRATION_LIBRARY_METADATA[id] : undefined;
+  const explicitDescription = integration["description"];
+  const explicitCategory = integration["category"];
+  const description = typeof explicitDescription === "string" && explicitDescription.trim().length > 0 ? explicitDescription.trim() : fromCatalog?.description;
+  const category = typeof explicitCategory === "string" && explicitCategory.trim().length > 0 ? explicitCategory.trim() : fromCatalog?.category;
+  const out = {};
+  if (description)
+    out.description = description;
+  if (category)
+    out.category = category;
+  return out;
+}
+var INTEGRATION_LIBRARY_METADATA;
+var init_library_metadata = __esm(() => {
+  INTEGRATION_LIBRARY_METADATA = {
+    airtable: {
+      description: "Manage Airtable bases, tables, and records",
+      category: "Business"
+    },
+    calcom: {
+      description: "Manage Cal.com bookings and schedules",
+      category: "Productivity"
+    },
+    cursor: {
+      description: "Manage Cursor Cloud Agents and background tasks",
+      category: "Engineering"
+    },
+    figma: {
+      description: "Access Figma files, comments, and components",
+      category: "Engineering"
+    },
+    github: {
+      description: "Manage GitHub repos, issues, and pull requests",
+      category: "Engineering"
+    },
+    gmail: {
+      description: "Send, read, and search Gmail messages",
+      category: "Communication"
+    },
+    gcal: {
+      description: "Manage Google Calendar events and schedules",
+      category: "Productivity"
+    },
+    hubspot: {
+      description: "Manage HubSpot contacts, deals, and tickets",
+      category: "Business"
+    },
+    intercom: {
+      description: "Manage Intercom contacts and conversations",
+      category: "Business"
+    },
+    linear: {
+      description: "Manage Linear issues, projects, and cycles",
+      category: "Engineering"
+    },
+    notion: {
+      description: "Manage Notion pages and databases",
+      category: "Productivity"
+    },
+    onedrive: {
+      description: "Manage OneDrive files, folders, and sharing",
+      category: "Storage"
+    },
+    outlook: {
+      description: "Manage Outlook mail, calendars, and contacts",
+      category: "Communication"
+    },
+    polar: {
+      description: "Manage Polar products, orders, and subscriptions",
+      category: "Business"
+    },
+    ramp: {
+      description: "Manage Ramp corporate cards, bills, and spend",
+      category: "Business"
+    },
+    slack: {
+      description: "Send and manage Slack messages and channels",
+      category: "Communication"
+    },
+    stripe: {
+      description: "Manage Stripe customers, payments, and subscriptions",
+      category: "Business"
+    },
+    todoist: {
+      description: "Manage Todoist tasks, projects, and labels",
+      category: "Productivity"
+    },
+    gslides: {
+      description: "Create and update Google Slides presentations",
+      category: "Productivity"
+    },
+    gsheets: {
+      description: "Read and update Google Sheets spreadsheets",
+      category: "Productivity"
+    },
+    gdocs: {
+      description: "Create and edit Google Docs documents",
+      category: "Productivity"
+    },
+    gdrive: {
+      description: "Manage Google Drive files, folders, and sharing",
+      category: "Storage"
+    },
+    vercel: {
+      description: "Manage Vercel projects, deployments, and domains",
+      category: "Engineering"
+    },
+    whatsapp: {
+      description: "Send WhatsApp messages and templates",
+      category: "Communication"
+    },
+    youtube: {
+      description: "Search and access YouTube videos and channels",
+      category: "Communication"
+    },
+    powerpoint: {
+      description: "Manage PowerPoint presentations and sharing",
+      category: "Productivity"
+    },
+    excel: {
+      description: "Manage Excel workbooks, worksheets, and tables",
+      category: "Productivity"
+    },
+    word: {
+      description: "Manage Word documents and sharing",
+      category: "Productivity"
+    },
+    dropbox: {
+      description: "Manage Dropbox files, folders, and sharing",
+      category: "Storage"
+    },
+    granola: {
+      description: "List and read Granola meeting notes and folders",
+      category: "Productivity"
+    },
+    mercury: {
+      description: "Manage Mercury bank accounts, cards, and transactions",
+      category: "Business"
+    },
+    zendesk: {
+      description: "Manage Zendesk tickets, users, and help center content",
+      category: "Business"
+    }
+  };
+});
+
+// ../integrations/integration-summary.ts
+function toConfiguredIntegrationSummary(integration) {
+  const row = integration;
+  const pres = integrationLibraryPresentationFields(row);
+  return {
+    id: integration.id,
+    name: row.name || integration.id,
+    logoUrl: row.logoUrl,
+    tools: integration.tools,
+    hasOAuth: !!integration.oauth,
+    scopes: integration.oauth?.scopes,
+    provider: integration.oauth?.provider,
+    ...pres
+  };
+}
+function toConfiguredIntegrationWithToolMetadata(integration, toolMetadata) {
+  return {
+    ...toConfiguredIntegrationSummary(integration),
+    toolMetadata
+  };
+}
+var init_integration_summary = __esm(() => {
+  init_library_metadata();
+});
+
 // ../utils/logger.ts
 function shouldLog(level, context) {
   return logLevelHierarchy[level] <= logLevelHierarchy[contextLogLevels[context]];
@@ -447,14 +621,8 @@ class OAuthHandler {
     const integrations = this.config.integrations || [];
     return {
       integrations: integrations.map((integration) => ({
-        id: integration.id,
-        name: integration.name || integration.id,
-        logoUrl: integration.logoUrl,
-        tools: integration.tools,
-        hasOAuth: !!integration.oauth,
-        scopes: integration.oauth?.scopes,
-        optionalScopes: integration.oauth?.optionalScopes,
-        provider: integration.oauth?.provider
+        ...toConfiguredIntegrationSummary(integration),
+        optionalScopes: integration.oauth?.optionalScopes
       }))
     };
   }
@@ -841,6 +1009,7 @@ class OAuthHandler {
 }
 var SERVER_LOG_CONTEXT = "server", logger2, MCP_SERVER_URL = "https://mcp.integrate.dev/api/v1/mcp";
 var init_base_handler = __esm(() => {
+  init_integration_summary();
   init_email_fetcher();
   init_logger();
   logger2 = createLogger("OAuthHandler", SERVER_LOG_CONTEXT);
@@ -1696,6 +1865,8 @@ class HttpSessionTransport {
 }
 
 // ../client.ts
+init_integration_summary();
+init_library_metadata();
 init_errors();
 init_logger();
 
@@ -3011,31 +3182,14 @@ class MCPClientBase {
             const serverConfig = this.__oauthConfig;
             const localIntegrations = serverConfig?.integrations || this.__configuredIntegrations;
             const formatLocalIntegrations = (integrations) => ({
-              integrations: integrations.map((integration) => ({
-                id: integration.id,
-                name: integration.name || integration.id,
-                logoUrl: integration.logoUrl,
-                tools: integration.tools,
-                hasOAuth: !!integration.oauth,
-                scopes: integration.oauth?.scopes,
-                provider: integration.oauth?.provider
-              }))
+              integrations: integrations.map((integration) => toConfiguredIntegrationSummary(integration))
             });
             if (hasApiKey || !this.__useServerConfig) {
               if (options?.includeToolMetadata && hasApiKey) {
                 await this.ensureConnected();
                 const integrationsWithMetadata = localIntegrations.map((integration) => {
                   const toolMetadata = integration.tools.map((toolName) => this.availableTools.get(toolName)).filter((tool) => !!tool);
-                  return {
-                    id: integration.id,
-                    name: integration.name || integration.id,
-                    logoUrl: integration.logoUrl,
-                    tools: integration.tools,
-                    hasOAuth: !!integration.oauth,
-                    scopes: integration.oauth?.scopes,
-                    provider: integration.oauth?.provider,
-                    toolMetadata
-                  };
+                  return toConfiguredIntegrationWithToolMetadata(integration, toolMetadata);
                 });
                 return { integrations: integrationsWithMetadata };
               }
@@ -3061,28 +3215,10 @@ class MCPClientBase {
                         }
                       }
                     }
-                    return {
-                      id: integration.id,
-                      name: integration.name || integration.id,
-                      logoUrl: integration.logoUrl,
-                      tools: integration.tools,
-                      hasOAuth: !!integration.oauth,
-                      scopes: integration.oauth?.scopes,
-                      provider: integration.oauth?.provider,
-                      toolMetadata
-                    };
+                    return toConfiguredIntegrationWithToolMetadata(integration, toolMetadata);
                   } catch (error) {
                     logger7.error(`Failed to fetch tool metadata for ${integration.id}:`, error);
-                    return {
-                      id: integration.id,
-                      name: integration.name || integration.id,
-                      logoUrl: integration.logoUrl,
-                      tools: integration.tools,
-                      hasOAuth: !!integration.oauth,
-                      scopes: integration.oauth?.scopes,
-                      provider: integration.oauth?.provider,
-                      toolMetadata: []
-                    };
+                    return toConfiguredIntegrationWithToolMetadata(integration, []);
                   }
                 }, 3);
                 return { integrations: integrationsWithMetadata };
@@ -3102,6 +3238,12 @@ class MCPClientBase {
                 return formatLocalIntegrations(localIntegrations);
               }
               const result = await response.json();
+              if (result.integrations && Array.isArray(result.integrations)) {
+                result.integrations = result.integrations.map((row) => ({
+                  ...row,
+                  ...integrationLibraryPresentationFields(row)
+                }));
+              }
               if (options?.includeToolMetadata && result.integrations) {
                 const { parallelWithLimit: parallelWithLimit2 } = await Promise.resolve().then(() => exports_concurrency);
                 const integrationsWithMetadata = await parallelWithLimit2(result.integrations, async (integration) => {
@@ -3126,12 +3268,14 @@ class MCPClientBase {
                     }
                     return {
                       ...integration,
+                      ...integrationLibraryPresentationFields(integration),
                       toolMetadata
                     };
                   } catch (error) {
                     logger7.error(`Failed to fetch tool metadata for ${integration.id}:`, error);
                     return {
                       ...integration,
+                      ...integrationLibraryPresentationFields(integration),
                       toolMetadata: []
                     };
                   }
@@ -3705,7 +3849,9 @@ class MCPClientBase {
     return success;
   }
 }
+
 // ../server.ts
+init_integration_summary();
 init_logger();
 
 // ../integrations/github.ts

package/dist/adapters/nextjs.js

@@ -284,6 +284,180 @@ function getContextCookieFromRequest(request) {
 }
 var CONTEXT_COOKIE_NAME = "__integrate_oauth_ctx", CONTEXT_COOKIE_MAX_AGE = 300;
 
+// ../integrations/library-metadata.ts
+function integrationLibraryPresentationFields(integration) {
+  const id = typeof integration["id"] === "string" ? integration["id"] : String(integration["id"] ?? "");
+  const fromCatalog = id ? INTEGRATION_LIBRARY_METADATA[id] : undefined;
+  const explicitDescription = integration["description"];
+  const explicitCategory = integration["category"];
+  const description = typeof explicitDescription === "string" && explicitDescription.trim().length > 0 ? explicitDescription.trim() : fromCatalog?.description;
+  const category = typeof explicitCategory === "string" && explicitCategory.trim().length > 0 ? explicitCategory.trim() : fromCatalog?.category;
+  const out = {};
+  if (description)
+    out.description = description;
+  if (category)
+    out.category = category;
+  return out;
+}
+var INTEGRATION_LIBRARY_METADATA;
+var init_library_metadata = __esm(() => {
+  INTEGRATION_LIBRARY_METADATA = {
+    airtable: {
+      description: "Manage Airtable bases, tables, and records",
+      category: "Business"
+    },
+    calcom: {
+      description: "Manage Cal.com bookings and schedules",
+      category: "Productivity"
+    },
+    cursor: {
+      description: "Manage Cursor Cloud Agents and background tasks",
+      category: "Engineering"
+    },
+    figma: {
+      description: "Access Figma files, comments, and components",
+      category: "Engineering"
+    },
+    github: {
+      description: "Manage GitHub repos, issues, and pull requests",
+      category: "Engineering"
+    },
+    gmail: {
+      description: "Send, read, and search Gmail messages",
+      category: "Communication"
+    },
+    gcal: {
+      description: "Manage Google Calendar events and schedules",
+      category: "Productivity"
+    },
+    hubspot: {
+      description: "Manage HubSpot contacts, deals, and tickets",
+      category: "Business"
+    },
+    intercom: {
+      description: "Manage Intercom contacts and conversations",
+      category: "Business"
+    },
+    linear: {
+      description: "Manage Linear issues, projects, and cycles",
+      category: "Engineering"
+    },
+    notion: {
+      description: "Manage Notion pages and databases",
+      category: "Productivity"
+    },
+    onedrive: {
+      description: "Manage OneDrive files, folders, and sharing",
+      category: "Storage"
+    },
+    outlook: {
+      description: "Manage Outlook mail, calendars, and contacts",
+      category: "Communication"
+    },
+    polar: {
+      description: "Manage Polar products, orders, and subscriptions",
+      category: "Business"
+    },
+    ramp: {
+      description: "Manage Ramp corporate cards, bills, and spend",
+      category: "Business"
+    },
+    slack: {
+      description: "Send and manage Slack messages and channels",
+      category: "Communication"
+    },
+    stripe: {
+      description: "Manage Stripe customers, payments, and subscriptions",
+      category: "Business"
+    },
+    todoist: {
+      description: "Manage Todoist tasks, projects, and labels",
+      category: "Productivity"
+    },
+    gslides: {
+      description: "Create and update Google Slides presentations",
+      category: "Productivity"
+    },
+    gsheets: {
+      description: "Read and update Google Sheets spreadsheets",
+      category: "Productivity"
+    },
+    gdocs: {
+      description: "Create and edit Google Docs documents",
+      category: "Productivity"
+    },
+    gdrive: {
+      description: "Manage Google Drive files, folders, and sharing",
+      category: "Storage"
+    },
+    vercel: {
+      description: "Manage Vercel projects, deployments, and domains",
+      category: "Engineering"
+    },
+    whatsapp: {
+      description: "Send WhatsApp messages and templates",
+      category: "Communication"
+    },
+    youtube: {
+      description: "Search and access YouTube videos and channels",
+      category: "Communication"
+    },
+    powerpoint: {
+      description: "Manage PowerPoint presentations and sharing",
+      category: "Productivity"
+    },
+    excel: {
+      description: "Manage Excel workbooks, worksheets, and tables",
+      category: "Productivity"
+    },
+    word: {
+      description: "Manage Word documents and sharing",
+      category: "Productivity"
+    },
+    dropbox: {
+      description: "Manage Dropbox files, folders, and sharing",
+      category: "Storage"
+    },
+    granola: {
+      description: "List and read Granola meeting notes and folders",
+      category: "Productivity"
+    },
+    mercury: {
+      description: "Manage Mercury bank accounts, cards, and transactions",
+      category: "Business"
+    },
+    zendesk: {
+      description: "Manage Zendesk tickets, users, and help center content",
+      category: "Business"
+    }
+  };
+});
+
+// ../integrations/integration-summary.ts
+function toConfiguredIntegrationSummary(integration) {
+  const row = integration;
+  const pres = integrationLibraryPresentationFields(row);
+  return {
+    id: integration.id,
+    name: row.name || integration.id,
+    logoUrl: row.logoUrl,
+    tools: integration.tools,
+    hasOAuth: !!integration.oauth,
+    scopes: integration.oauth?.scopes,
+    provider: integration.oauth?.provider,
+    ...pres
+  };
+}
+function toConfiguredIntegrationWithToolMetadata(integration, toolMetadata) {
+  return {
+    ...toConfiguredIntegrationSummary(integration),
+    toolMetadata
+  };
+}
+var init_integration_summary = __esm(() => {
+  init_library_metadata();
+});
+
 // ../utils/logger.ts
 function shouldLog(level, context) {
   return logLevelHierarchy[level] <= logLevelHierarchy[contextLogLevels[context]];
@@ -447,14 +621,8 @@ class OAuthHandler {
     const integrations = this.config.integrations || [];
     return {
       integrations: integrations.map((integration) => ({
-        id: integration.id,
-        name: integration.name || integration.id,
-        logoUrl: integration.logoUrl,
-        tools: integration.tools,
-        hasOAuth: !!integration.oauth,
-        scopes: integration.oauth?.scopes,
-        optionalScopes: integration.oauth?.optionalScopes,
-        provider: integration.oauth?.provider
+        ...toConfiguredIntegrationSummary(integration),
+        optionalScopes: integration.oauth?.optionalScopes
       }))
     };
   }
@@ -841,6 +1009,7 @@ class OAuthHandler {
 }
 var SERVER_LOG_CONTEXT = "server", logger2, MCP_SERVER_URL = "https://mcp.integrate.dev/api/v1/mcp";
 var init_base_handler = __esm(() => {
+  init_integration_summary();
   init_email_fetcher();
   init_logger();
   logger2 = createLogger("OAuthHandler", SERVER_LOG_CONTEXT);