@app-connect/core 1.7.25 → 1.7.27

package/mcp/tools/doAuth.js

@@ -1,60 +1,60 @@
-const { createAuthSession } = require('../../lib/authSession');
-
-/**
- * MCP Tool: Do Authentication (widget-only)
- *
- * Creates a server-side OAuth session for the given sessionId.
- * The widget generates the sessionId and authUri client-side for instant display,
- * then calls this endpoint in the background to register the session in the DB
- * so the OAuth callback can resolve it.
- */
-
-const toolDefinition = {
-    name: 'doAuth',
-    description: 'Create a server-side OAuth session. Widget-only — not called by AI model.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            connectorName: {
-                type: 'string',
-                description: 'Connector platform name'
-            },
-            hostname: {
-                type: 'string',
-                description: 'Resolved hostname for the CRM instance'
-            }
-        },
-        required: ['connectorName']
-    },
-    annotations: {
-        readOnlyHint: false,
-        openWorldHint: false,
-        destructiveHint: false
-    }
-};
-
-async function execute(args) {
-    try {
-        const { sessionId, connectorName, hostname = '' } = args;
-
-        if (!sessionId || !connectorName) {
-            return { success: false, error: 'Missing required fields: sessionId, connectorName' };
-        }
-
-        await createAuthSession(sessionId, {
-            platform: connectorName,
-            hostname,
-        });
-
-        return { success: true };
-    } catch (error) {
-        return {
-            success: false,
-            error: error.message || 'Unknown error occurred',
-            errorDetails: error.stack,
-        };
-    }
-}
-
-exports.definition = toolDefinition;
-exports.execute = execute;
+const { createAuthSession } = require('../../lib/authSession');
+
+/**
+ * MCP Tool: Do Authentication (widget-only)
+ *
+ * Creates a server-side OAuth session for the given sessionId.
+ * The widget generates the sessionId and authUri client-side for instant display,
+ * then calls this endpoint in the background to register the session in the DB
+ * so the OAuth callback can resolve it.
+ */
+
+const toolDefinition = {
+    name: 'doAuth',
+    description: 'Create a server-side OAuth session. Widget-only — not called by AI model.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            connectorName: {
+                type: 'string',
+                description: 'Connector platform name'
+            },
+            hostname: {
+                type: 'string',
+                description: 'Resolved hostname for the CRM instance'
+            }
+        },
+        required: ['connectorName']
+    },
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false
+    }
+};
+
+async function execute(args) {
+    try {
+        const { sessionId, connectorName, hostname = '' } = args;
+
+        if (!sessionId || !connectorName) {
+            return { success: false, error: 'Missing required fields: sessionId, connectorName' };
+        }
+
+        await createAuthSession(sessionId, {
+            platform: connectorName,
+            hostname,
+        });
+
+        return { success: true };
+    } catch (error) {
+        return {
+            success: false,
+            error: error.message || 'Unknown error occurred',
+            errorDetails: error.stack,
+        };
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;

package/mcp/tools/findContactByName.js

@@ -1,93 +1,93 @@
-const jwt = require('../../lib/jwt');
-const connectorRegistry = require('../../connector/registry');
-const contactCore = require('../../handlers/contact');
-
-/**
- * MCP Tool: Find Contact With Name
- * 
- * This tool searches for a contact in the CRM platform by name.
- * It uses the platform-specific connector to find matching contacts.
- */
-
-const toolDefinition = {
-    name: 'findContactByName',
-    description: '⚠️ REQUIRES CRM CONNECTION. | Search for a contact in the CRM platform by name. Returns contact details if found.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            name: {
-                type: 'string',
-                description: 'Name to search for'
-            }
-        },
-        required: ['name']
-    },
-    annotations: {
-        readOnlyHint: true,
-        openWorldHint: true,
-        destructiveHint: false
-    }
-};
-
-/**
- * Execute the findContactByName tool
- * @param {Object} args - The tool arguments
- * @param {string} args.name - Name to search for
- * @returns {Object} Result object with contact information
- */
-async function execute(args) {
-    try {
-        const { name, jwtToken } = args;
-        if (!jwtToken) {
-            throw new Error('Not authenticated. Please connect to your CRM first.');
-        }
-        // Decode JWT to get userId and platform
-        const decodedToken = jwt.decodeJwt(jwtToken);
-        if (!decodedToken) {
-            throw new Error('Invalid JWT token');
-        }
-        const { id: userId, platform } = decodedToken;
-        
-        if (!userId) {
-            throw new Error('Invalid JWT token: userId not found');
-        }
-
-        // Get the platform connector module
-        const platformModule = connectorRegistry.getConnector(platform);
-        
-        if (!platformModule) {
-            throw new Error(`Platform connector not found for: ${platform}`);
-        }
-
-        // Check if findContactByName is implemented
-        if (!platformModule.findContactWithName) {
-            throw new Error(`findContactByName is not implemented for platform: ${platform}`);
-        }
-
-        // Call the findContactByName method
-        const { successful, returnMessage, contact } = await contactCore.findContactWithName({ platform, userId, name });
-        if (successful) {
-            return {
-                success: true,
-                data: contact,
-            };
-        }
-        else {
-            return {
-                success: false,
-                error: returnMessage.message,
-            };
-        }
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: error.message || 'Unknown error occurred',
-            errorDetails: error.stack
-        };
-    }
-}
-
-exports.definition = toolDefinition;
-exports.execute = execute;
-
+const jwt = require('../../lib/jwt');
+const connectorRegistry = require('../../connector/registry');
+const contactCore = require('../../handlers/contact');
+
+/**
+ * MCP Tool: Find Contact With Name
+ * 
+ * This tool searches for a contact in the CRM platform by name.
+ * It uses the platform-specific connector to find matching contacts.
+ */
+
+const toolDefinition = {
+    name: 'findContactByName',
+    description: '⚠️ REQUIRES CRM CONNECTION. | Search for a contact in the CRM platform by name. Returns contact details if found.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Name to search for'
+            }
+        },
+        required: ['name']
+    },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+        destructiveHint: false
+    }
+};
+
+/**
+ * Execute the findContactByName tool
+ * @param {Object} args - The tool arguments
+ * @param {string} args.name - Name to search for
+ * @returns {Object} Result object with contact information
+ */
+async function execute(args) {
+    try {
+        const { name, jwtToken } = args;
+        if (!jwtToken) {
+            throw new Error('Not authenticated. Please connect to your CRM first.');
+        }
+        // Decode JWT to get userId and platform
+        const decodedToken = jwt.decodeJwt(jwtToken);
+        if (!decodedToken) {
+            throw new Error('Invalid JWT token');
+        }
+        const { id: userId, platform } = decodedToken;
+        
+        if (!userId) {
+            throw new Error('Invalid JWT token: userId not found');
+        }
+
+        // Get the platform connector module
+        const platformModule = connectorRegistry.getConnector(platform);
+        
+        if (!platformModule) {
+            throw new Error(`Platform connector not found for: ${platform}`);
+        }
+
+        // Check if findContactByName is implemented
+        if (!platformModule.findContactWithName) {
+            throw new Error(`findContactByName is not implemented for platform: ${platform}`);
+        }
+
+        // Call the findContactByName method
+        const { successful, returnMessage, contact } = await contactCore.findContactWithName({ platform, userId, name });
+        if (successful) {
+            return {
+                success: true,
+                data: contact,
+            };
+        }
+        else {
+            return {
+                success: false,
+                error: returnMessage.message,
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message || 'Unknown error occurred',
+            errorDetails: error.stack
+        };
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;
+

package/mcp/tools/findContactByPhone.js

@@ -1,101 +1,101 @@
-const jwt = require('../../lib/jwt');
-const connectorRegistry = require('../../connector/registry');
-const contactCore = require('../../handlers/contact');
-
-/**
- * MCP Tool: Find Contact
- * 
- * This tool searches for a contact in the CRM platform by phone number.
- * It uses the platform-specific connector to find matching contacts.
- */
-
-const toolDefinition = {
-    name: 'findContactByPhone',
-    description: '⚠️ REQUIRES CRM CONNECTION. | Search for a contact in the CRM platform by phone number. Returns contact details if found.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            phoneNumber: {
-                type: 'string',
-                description: 'Phone number to search for, if not in E.164 format, convert it to E.164 format'
-            },
-            overridingFormat: {
-                type: 'string',
-                description: 'Overriding format to search for'
-            },
-            isExtension: {
-                type: 'boolean',
-                description: 'Whether the request is from an extension'
-            }
-        },
-        required: ['phoneNumber']
-    },
-    annotations: {
-        readOnlyHint: true,
-        openWorldHint: true,
-        destructiveHint: false
-    }
-};
-
-/**
- * Execute the findContactByPhone tool
- * @param {Object} args - The tool arguments
- * @param {string} args.jwtToken - JWT token with user and platform info
- * @param {string} [args.phoneNumber] - Phone number to search for
- * @param {string} [args.overridingFormat] - Overriding format to search for
- * @param {string} [args.isExtension] - Whether the request is from an extension
- * @returns {Object} Result object with contact information
- */
-async function execute(args) {
-    try {
-        const { jwtToken, phoneNumber, overridingFormat, isExtension } = args;
-
-        // Decode JWT to get userId and platform
-        const decodedToken = jwt.decodeJwt(jwtToken);
-        if (!decodedToken) {
-            throw new Error('Invalid JWT token');
-        }
-        const { id: userId, platform } = decodedToken;
-        
-        if (!userId) {
-            throw new Error('Invalid JWT token: userId not found');
-        }
-
-        // Get the platform connector module
-        const platformModule = connectorRegistry.getConnector(platform);
-        
-        if (!platformModule) {
-            throw new Error(`Platform connector not found for: ${platform}`);
-        }
-
-        // Check if findContactByPhone is implemented
-        if (!platformModule.findContact) {
-            throw new Error(`findContactByPhone is not implemented for platform: ${platform}`);
-        }
-
-        // Call the findContactByPhone method
-        const { successful, returnMessage, contact } = await contactCore.findContact({ platform, userId, phoneNumber, overridingFormat: overridingFormat ?? '', isExtension: isExtension ?? false });
-        if (successful) {
-            return {
-                success: true,
-                data: contact,
-            };
-        }
-        else {
-            return {
-                success: false,
-                error: returnMessage.message,
-            };
-        }
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: error.message || 'Unknown error occurred',
-            errorDetails: error.stack
-        };
-    }
-}
-
-exports.definition = toolDefinition;
-exports.execute = execute;
+const jwt = require('../../lib/jwt');
+const connectorRegistry = require('../../connector/registry');
+const contactCore = require('../../handlers/contact');
+
+/**
+ * MCP Tool: Find Contact
+ * 
+ * This tool searches for a contact in the CRM platform by phone number.
+ * It uses the platform-specific connector to find matching contacts.
+ */
+
+const toolDefinition = {
+    name: 'findContactByPhone',
+    description: '⚠️ REQUIRES CRM CONNECTION. | Search for a contact in the CRM platform by phone number. Returns contact details if found.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            phoneNumber: {
+                type: 'string',
+                description: 'Phone number to search for, if not in E.164 format, convert it to E.164 format'
+            },
+            overridingFormat: {
+                type: 'string',
+                description: 'Overriding format to search for'
+            },
+            isExtension: {
+                type: 'boolean',
+                description: 'Whether the request is from an extension'
+            }
+        },
+        required: ['phoneNumber']
+    },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+        destructiveHint: false
+    }
+};
+
+/**
+ * Execute the findContactByPhone tool
+ * @param {Object} args - The tool arguments
+ * @param {string} args.jwtToken - JWT token with user and platform info
+ * @param {string} [args.phoneNumber] - Phone number to search for
+ * @param {string} [args.overridingFormat] - Overriding format to search for
+ * @param {string} [args.isExtension] - Whether the request is from an extension
+ * @returns {Object} Result object with contact information
+ */
+async function execute(args) {
+    try {
+        const { jwtToken, phoneNumber, overridingFormat, isExtension } = args;
+
+        // Decode JWT to get userId and platform
+        const decodedToken = jwt.decodeJwt(jwtToken);
+        if (!decodedToken) {
+            throw new Error('Invalid JWT token');
+        }
+        const { id: userId, platform } = decodedToken;
+        
+        if (!userId) {
+            throw new Error('Invalid JWT token: userId not found');
+        }
+
+        // Get the platform connector module
+        const platformModule = connectorRegistry.getConnector(platform);
+        
+        if (!platformModule) {
+            throw new Error(`Platform connector not found for: ${platform}`);
+        }
+
+        // Check if findContactByPhone is implemented
+        if (!platformModule.findContact) {
+            throw new Error(`findContactByPhone is not implemented for platform: ${platform}`);
+        }
+
+        // Call the findContactByPhone method
+        const { successful, returnMessage, contact } = await contactCore.findContact({ platform, userId, phoneNumber, overridingFormat: overridingFormat ?? '', isExtension: isExtension ?? false });
+        if (successful) {
+            return {
+                success: true,
+                data: contact,
+            };
+        }
+        else {
+            return {
+                success: false,
+                error: returnMessage.message,
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message || 'Unknown error occurred',
+            errorDetails: error.stack
+        };
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;