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

package/dist/index.js

@@ -800,6 +800,182 @@ var MCPMethod;
   MCPMethod2["PROMPTS_GET"] = "prompts/get";
 })(MCPMethod ||= {});
 
+// src/integrations/library-metadata.ts
+var INTEGRATION_CATEGORY_ORDER = [
+  "Productivity",
+  "Business",
+  "Communication",
+  "Engineering",
+  "Storage",
+  "Other"
+];
+var 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"
+  }
+};
+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;
+}
+
+// src/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
+  };
+}
+
 // src/client.ts
 init_errors();
 
@@ -2238,31 +2414,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 };
               }
@@ -2288,28 +2447,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) {
                     logger5.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 };
@@ -2329,6 +2470,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) => {
@@ -2353,12 +2500,14 @@ class MCPClientBase {
                     }
                     return {
                       ...integration,
+                      ...integrationLibraryPresentationFields(integration),
                       toolMetadata
                     };
                   } catch (error) {
                     logger5.error(`Failed to fetch tool metadata for ${integration.id}:`, error);
                     return {
                       ...integration,
+                      ...integrationLibraryPresentationFields(integration),
                       toolMetadata: []
                     };
                   }
@@ -3103,14 +3252,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
       }))
     };
   }
@@ -5690,6 +5833,7 @@ export {
   MCPClientBase,
   MAX_TRIGGER_STEPS,
   IntegrateSDKError,
+  INTEGRATION_CATEGORY_ORDER,
   HttpSessionTransport,
   ConnectionError,
   AuthorizationError,

package/dist/oauth.js

@@ -27,6 +27,180 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
+// src/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"
+    }
+  };
+});
+
+// src/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();
+});
+
 // src/utils/logger.ts
 function shouldLog(level, context) {
   return logLevelHierarchy[level] <= logLevelHierarchy[contextLogLevels[context]];
@@ -472,14 +646,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
       }))
     };
   }
@@ -866,6 +1034,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);