@app-connect/core 1.7.25 → 1.7.27

package/mcp/tools/getCallLog.js

@@ -1,102 +1,111 @@
-const jwt = require('../../lib/jwt');
-const connectorRegistry = require('../../connector/registry');
-const logCore = require('../../handlers/log');
-
-/**
- * MCP Tool: Get Call Log
- * 
- * This tool retrieves call logs from the CRM platform by session IDs.
- */
-
-const toolDefinition = {
-    name: 'getCallLog',
-    description: '⚠️ REQUIRES AUTHENTICATION: User must first authenticate using the "auth" tool to obtain a JWT token before using this tool. | Get call logs from the CRM platform by session IDs. Returns log details if found.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            jwtToken: {
-                type: 'string',
-                description: 'JWT token containing userId and platform information. If user does not have this, direct them to use the "auth" tool first.'
-            },
-            sessionIds: {
-                type: 'string',
-                description: 'Session IDs to retrieve, seprated by commas'
-            },
-            requireDetails: {
-                type: 'boolean',
-                description: 'Whether to require detailed log information. If true, will call CRM API. Otherwise will just query in our own database',
-                default: false
-            }
-        },
-        required: ['jwtToken', 'sessionIds']
-    }
-};
-
-/**
- * Execute the getCallLog tool
- * @param {Object} args - The tool arguments
- * @param {string} args.jwtToken - JWT token with user and platform info
- * @param {string} args.sessionIds - Session IDs to retrieve, seprated by commas
- * @param {boolean} [args.requireDetails] - Whether to require detailed log information. If true, will call CRM API. Otherwise will just query in our own database.
- * @returns {Object} Result object with call log information
- */
-async function execute(args) {
-    try {
-        const { jwtToken, sessionIds, requireDetails = false } = 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 getCallLog is implemented
-        if (!platformModule.getCallLog) {
-            throw new Error(`getCallLog is not implemented for platform: ${platform}`);
-        }
-
-        // Call the getCallLog method
-        const { successful, logs, returnMessage } = await logCore.getCallLog({ 
-            userId, 
-            sessionIds, 
-            platform, 
-            requireDetails 
-        });
-        
-        if (successful) {
-            return {
-                success: true,
-                data: logs,
-            };
-        }
-        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 logCore = require('../../handlers/log');
+
+/**
+ * MCP Tool: Get Call Log
+ * 
+ * This tool retrieves call logs from the CRM platform by session IDs.
+ */
+
+const toolDefinition = {
+    name: 'getCallLog',
+    description: '⚠️ REQUIRES AUTHENTICATION: User must first authenticate using the "auth" tool to obtain a JWT token before using this tool. | Get call logs from the CRM platform by session IDs. Returns log details if found.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            jwtToken: {
+                type: 'string',
+                description: 'JWT token containing userId and platform information. If user does not have this, direct them to use the "auth" tool first.'
+            },
+            sessionIds: {
+                type: 'string',
+                description: 'Session IDs to retrieve, seprated by commas'
+            },
+            extensionNumber: {
+                type: 'string',
+                description: 'RingCentral extension number to match with each session ID'
+            },
+            requireDetails: {
+                type: 'boolean',
+                description: 'Whether to require detailed log information. If true, will call CRM API. Otherwise will just query in our own database',
+                default: false
+            }
+        },
+        required: ['jwtToken', 'sessionIds']
+    }
+};
+
+/**
+ * Execute the getCallLog tool
+ * @param {Object} args - The tool arguments
+ * @param {string} args.jwtToken - JWT token with user and platform info
+ * @param {string} args.sessionIds - Session IDs to retrieve, seprated by commas
+ * @param {string} [args.extensionNumber] - RingCentral extension number used to scope the lookup.
+ * @param {boolean} [args.requireDetails] - Whether to require detailed log information. If true, will call CRM API. Otherwise will just query in our own database.
+ * @returns {Object} Result object with call log information
+ */
+async function execute(args) {
+    try {
+        const { jwtToken, sessionIds, extensionNumber, requireDetails = false } = 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 getCallLog is implemented
+        if (!platformModule.getCallLog) {
+            throw new Error(`getCallLog is not implemented for platform: ${platform}`);
+        }
+
+        // Call the getCallLog method
+        const getCallLogParams = {
+            userId, 
+            sessionIds, 
+            platform, 
+            requireDetails 
+        };
+        if (extensionNumber) {
+            getCallLogParams.extensionNumber = extensionNumber;
+        }
+        const { successful, logs, returnMessage } = await logCore.getCallLog(getCallLogParams);
+        
+        if (successful) {
+            return {
+                success: true,
+                data: logs,
+            };
+        }
+        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/getGoogleFilePicker.js

@@ -1,99 +1,99 @@
-const jwt = require('../../lib/jwt');
-const { UserModel } = require('../../models/userModel');
-const axios = require('axios');
-
-/**
- * MCP Tool: Get Google File Picker
- * 
- * Returns the URL for the Google Sheets file picker.
- * The user must visit this URL in a browser to select a Google Sheet.
- */
-
-const toolDefinition = {
-    name: 'getGoogleFilePicker',
-    description: '⚠️ REQUIRES CRM CONNECTION. | Returns a URL for the Google Sheets file picker (1st preference) OR create a new sheet with input sheet name (2nd preference). The user should open this URL in their browser to select a Google Sheet for logging.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            sheetName: {
-                type: 'string',
-                description: 'OPTIONAL. Name of the new sheet to create.'
-            }
-        },
-        required: []
-    },
-    annotations: {
-        readOnlyHint: false,
-        openWorldHint: true,
-        destructiveHint: false
-    }
-};
-
-/**
- * Execute the getGoogleFilePicker tool
- * @param {Object} args - The tool arguments
- * @param {string} args.jwtToken - JWT token containing userId
- * @param {string} args.sheetName - Name of the new sheet to create
- * @returns {Object} Result object with file picker URL
- */
-async function execute(args) {
-    try {
-        const { jwtToken, sheetName } = args;
-
-        if (!jwtToken) {
-            return {
-                success: false,
-                error: 'JWT token is required. Please connect to the CRM first using getPublicConnectors.'
-            };
-        }
-
-        // Decode JWT to get userId
-        const unAuthData = jwt.decodeJwt(jwtToken);
-
-        if (!unAuthData?.id) {
-            return {
-                success: false,
-                error: 'Invalid JWT token: userId not found'
-            };
-        }
-
-        // Find the user
-        const user = await UserModel.findByPk(unAuthData.id);
-
-        if (!user) {
-            return {
-                success: false,
-                error: 'User not found. Please connect to the CRM first using getPublicConnectors.'
-            };
-        }
-
-
-        if (sheetName) {
-            const createSheetResponse = await axios.post(`${process.env.APP_SERVER}/googleSheets/sheet?jwtToken=${jwtToken}`, { name: sheetName });
-            return createSheetResponse.data;
-        }
-        else {
-            // Generate the file picker URL
-            const filePickerUrl = `${process.env.APP_SERVER}/googleSheets/filePicker?token=${jwtToken}`;
-
-            return {
-                success: true,
-                data: {
-                    filePickerUrl,
-                    message: 'Please open this URL in a browser to select a Google Sheet. After selecting a sheet, it will be configured for logging your calls and messages.'
-                }
-            };
-        }
-    }
-    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 { UserModel } = require('../../models/userModel');
+const axios = require('axios');
+
+/**
+ * MCP Tool: Get Google File Picker
+ * 
+ * Returns the URL for the Google Sheets file picker.
+ * The user must visit this URL in a browser to select a Google Sheet.
+ */
+
+const toolDefinition = {
+    name: 'getGoogleFilePicker',
+    description: '⚠️ REQUIRES CRM CONNECTION. | Returns a URL for the Google Sheets file picker (1st preference) OR create a new sheet with input sheet name (2nd preference). The user should open this URL in their browser to select a Google Sheet for logging.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            sheetName: {
+                type: 'string',
+                description: 'OPTIONAL. Name of the new sheet to create.'
+            }
+        },
+        required: []
+    },
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: true,
+        destructiveHint: false
+    }
+};
+
+/**
+ * Execute the getGoogleFilePicker tool
+ * @param {Object} args - The tool arguments
+ * @param {string} args.jwtToken - JWT token containing userId
+ * @param {string} args.sheetName - Name of the new sheet to create
+ * @returns {Object} Result object with file picker URL
+ */
+async function execute(args) {
+    try {
+        const { jwtToken, sheetName } = args;
+
+        if (!jwtToken) {
+            return {
+                success: false,
+                error: 'JWT token is required. Please connect to the CRM first using getPublicConnectors.'
+            };
+        }
+
+        // Decode JWT to get userId
+        const unAuthData = jwt.decodeJwt(jwtToken);
+
+        if (!unAuthData?.id) {
+            return {
+                success: false,
+                error: 'Invalid JWT token: userId not found'
+            };
+        }
+
+        // Find the user
+        const user = await UserModel.findByPk(unAuthData.id);
+
+        if (!user) {
+            return {
+                success: false,
+                error: 'User not found. Please connect to the CRM first using getPublicConnectors.'
+            };
+        }
+
+
+        if (sheetName) {
+            const createSheetResponse = await axios.post(`${process.env.APP_SERVER}/googleSheets/sheet?jwtToken=${jwtToken}`, { name: sheetName });
+            return createSheetResponse.data;
+        }
+        else {
+            // Generate the file picker URL
+            const filePickerUrl = `${process.env.APP_SERVER}/googleSheets/filePicker?token=${jwtToken}`;
+
+            return {
+                success: true,
+                data: {
+                    filePickerUrl,
+                    message: 'Please open this URL in a browser to select a Google Sheet. After selecting a sheet, it will be configured for logging your calls and messages.'
+                }
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message || 'Unknown error occurred',
+            errorDetails: error.stack
+        };
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;
+

package/mcp/tools/getHelp.js

@@ -1,43 +1,43 @@
-/**
- * MCP Tool: Get Help
- * 
- * This tool provides users with a friendly guide to available capabilities
- * and how to get started with the RingCentral CRM integration.
- */
-
-const toolDefinition = {
-    name: 'getHelp',
-    description: 'Get a quick guide on what this integration can do and how to get started.',
-    inputSchema: {
-        type: 'object',
-        properties: {},
-        required: []
-    },
-    annotations: {
-        readOnlyHint: true,
-        openWorldHint: false,
-        destructiveHint: false
-    }
-};
-
-/**
- * Execute the getHelp tool
- * @returns {Object} Result object with help information
- */
-async function execute() {
-    return {
-        success: true,
-        data: {
-            overview: "I help you connect RingCentral with your CRM to log calls.",
-            steps: [
-                '1. Tell me to show all connectors and let me connect you to your CRM',
-                '2. Follow authorization flow to authorize your CRM',
-                '3. Once authorized, I can help find contacts and log your calls'
-            ]
-        }
-    };
-}
-
-exports.definition = toolDefinition;
-exports.execute = execute;
-
+/**
+ * MCP Tool: Get Help
+ * 
+ * This tool provides users with a friendly guide to available capabilities
+ * and how to get started with the RingCentral CRM integration.
+ */
+
+const toolDefinition = {
+    name: 'getHelp',
+    description: 'Get a quick guide on what this integration can do and how to get started.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
+    },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false
+    }
+};
+
+/**
+ * Execute the getHelp tool
+ * @returns {Object} Result object with help information
+ */
+async function execute() {
+    return {
+        success: true,
+        data: {
+            overview: "I help you connect RingCentral with your CRM to log calls.",
+            steps: [
+                '1. Tell me to show all connectors and let me connect you to your CRM',
+                '2. Follow authorization flow to authorize your CRM',
+                '3. Once authorized, I can help find contacts and log your calls'
+            ]
+        }
+    };
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;
+