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

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();
 
@@ -1429,6 +1605,7 @@ class OAuthManager {
     }
     const provider = tokenData.provider || pendingAuth.provider;
     const tokenDataToStore = {
+      sessionToken: tokenData.sessionToken,
       accessToken: tokenData.accessToken,
       refreshToken: tokenData.refreshToken,
       tokenType: tokenData.tokenType,
@@ -1470,6 +1647,7 @@ class OAuthManager {
     try {
       const response = await this.exchangeCodeForToken(pendingAuth.provider, code, pendingAuth.codeVerifier, state);
       const tokenData = {
+        sessionToken: response.sessionToken,
         accessToken: response.accessToken,
         refreshToken: response.refreshToken,
         tokenType: response.tokenType,
@@ -2043,6 +2221,7 @@ class MCPClientBase {
   authState = new Map;
   oauthManager;
   eventEmitter = new SimpleEventEmitter;
+  sessionToken;
   apiRouteBase;
   apiBaseUrl;
   databaseDetected = false;
@@ -2087,6 +2266,7 @@ class MCPClientBase {
       setProviderToken: config.setProviderToken,
       removeProviderToken: config.removeProviderToken
     });
+    this.setSessionToken(config.sessionToken || this.loadSessionTokenFromStorage());
     for (const integration of this.integrations) {
       for (const toolName of integration.tools) {
         this.enabledToolNames.add(toolName);
@@ -2109,6 +2289,9 @@ class MCPClientBase {
             const provider = integration.oauth.provider;
             try {
               const tokenData = await this.oauthManager.getProviderToken(provider);
+              if (tokenData?.sessionToken && !this.sessionToken) {
+                this.setSessionToken(tokenData.sessionToken);
+              }
               const currentState = this.authState.get(provider);
               if (currentState && !currentState.authenticated && !currentState.lastError) {
                 this.authState.set(provider, { authenticated: !!tokenData });
@@ -2133,6 +2316,9 @@ class MCPClientBase {
           const provider = integration.oauth.provider;
           const tokenData = this.oauthManager.getProviderTokenFromCache(provider);
           if (tokenData) {
+            if (tokenData.sessionToken && !this.sessionToken) {
+              this.setSessionToken(tokenData.sessionToken);
+            }
             this.authState.set(provider, { authenticated: true });
           }
         }
@@ -2238,31 +2424,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 +2457,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 +2480,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 +2510,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: []
                     };
                   }
@@ -2501,17 +2660,15 @@ class MCPClientBase {
     const headers = {
       "Content-Type": "application/json"
     };
+    if (this.sessionToken) {
+      headers["Authorization"] = `Bearer ${this.sessionToken}`;
+      headers["X-Session-Token"] = this.sessionToken;
+    }
     const integrationsHeader = this.getIntegrationHeaderValue();
     if (integrationsHeader) {
       headers["X-Integrations"] = integrationsHeader;
     }
     Object.assign(headers, integrationHeaders);
-    if (provider) {
-      const tokenData = await this.oauthManager.getProviderToken(provider, undefined, options?.context);
-      if (tokenData) {
-        headers["Authorization"] = `Bearer ${tokenData.accessToken}`;
-      }
-    }
     const response = await fetch(url, {
       method: "POST",
       headers,
@@ -2710,7 +2867,35 @@ class MCPClientBase {
   off(event, handler) {
     this.eventEmitter.off(event, handler);
   }
+  loadSessionTokenFromStorage() {
+    if (typeof window === "undefined" || !window.sessionStorage) {
+      return;
+    }
+    try {
+      return window.sessionStorage.getItem("integrate_session_token") || undefined;
+    } catch {
+      return;
+    }
+  }
+  setSessionToken(sessionToken) {
+    this.sessionToken = sessionToken;
+    if (sessionToken) {
+      this.transport.setHeader("X-Session-Token", sessionToken);
+    } else {
+      this.transport.removeHeader("X-Session-Token");
+    }
+    if (typeof window !== "undefined" && window.sessionStorage) {
+      try {
+        if (sessionToken) {
+          window.sessionStorage.setItem("integrate_session_token", sessionToken);
+        } else {
+          window.sessionStorage.removeItem("integrate_session_token");
+        }
+      } catch {}
+    }
+  }
   clearSessionToken() {
+    this.setSessionToken(undefined);
     this.oauthManager.clearAllProviderTokens();
     for (const integration of this.integrations) {
       if (integration.oauth) {
@@ -2852,6 +3037,7 @@ class MCPClientBase {
         if (tokenData) {
           this.eventEmitter.emit("auth:complete", {
             provider,
+            sessionToken: tokenData.sessionToken || this.sessionToken,
             accessToken: tokenData.accessToken,
             expiresAt: tokenData.expiresAt
           });
@@ -2867,6 +3053,7 @@ class MCPClientBase {
       if (tokenData) {
         this.eventEmitter.emit("auth:complete", {
           provider,
+          sessionToken: tokenData.sessionToken || this.sessionToken,
           accessToken: tokenData.accessToken,
           expiresAt: tokenData.expiresAt
         });
@@ -2880,9 +3067,13 @@ class MCPClientBase {
   async handleOAuthCallback(params) {
     try {
       const result = params.tokenData ? await this.oauthManager.handleCallbackWithToken(params.code, params.state, params.tokenData) : await this.oauthManager.handleCallback(params.code, params.state);
+      if (result.sessionToken) {
+        this.setSessionToken(result.sessionToken);
+      }
       this.authState.set(result.provider, { authenticated: true });
       this.eventEmitter.emit("auth:complete", {
         provider: result.provider,
+        sessionToken: result.sessionToken || this.sessionToken,
         accessToken: result.accessToken,
         expiresAt: result.expiresAt
       });
@@ -3103,14 +3294,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
       }))
     };
   }
@@ -3280,6 +3465,7 @@ class OAuthHandler {
     if (this.config.setProviderToken) {
       try {
         const tokenData = {
+          sessionToken: result.sessionToken,
           accessToken: result.accessToken,
           refreshToken: result.refreshToken,
           tokenType: result.tokenType,
@@ -3635,7 +3821,7 @@ function createNextOAuthHandler(config) {
         const codeModeHeader = req.headers.get("x-integrate-code-mode");
         const tokensHeader = req.headers.get("x-integrate-tokens");
         const toolName = typeof body?.name === "string" ? body.name : "";
-        if (codeModeHeader === "1" && tokensHeader && toolName) {
+        if (codeModeHeader === "1" && !authHeader && tokensHeader && toolName) {
           try {
             const tokens = JSON.parse(tokensHeader);
             let best = null;
@@ -5690,6 +5876,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
       }))
     };
   }
@@ -649,6 +817,7 @@ class OAuthHandler {
     if (this.config.setProviderToken) {
       try {
         const tokenData = {
+          sessionToken: result.sessionToken,
           accessToken: result.accessToken,
           refreshToken: result.refreshToken,
           tokenType: result.tokenType,
@@ -866,6 +1035,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);