@app-connect/core 1.7.8 → 1.7.11

package/mcp/tools/getCallLog.js

@@ -0,0 +1,98 @@
+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 { id: userId, platform } = jwt.decodeJwt(jwtToken);
+        
+        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;
+

package/mcp/tools/getHelp.js

@@ -0,0 +1,39 @@
+/**
+ * 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: []
+    }
+};
+
+/**
+ * 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'
+            ],
+            supportedCRMs: ["Clio"],
+        }
+    };
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;
+

package/mcp/tools/getPublicConnectors.js

@@ -0,0 +1,46 @@
+const developerPortal = require('../../connector/developerPortal');
+
+/**
+ * MCP Tool: Get Public Connectors
+ * 
+ * This tool retrieves a list of public connectors from the developer portal.
+ */
+
+const toolDefinition = {
+    name: 'getPublicConnectors',
+    description: 'Auth flow step.1. Get a list of all available connectors from the developer portal. Returns a list of connector names for users to choose. Next step is calling step.2 "setConnector" tool.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
+    }
+};
+
+/**
+ * Execute the getPublicConnectors tool
+ * @returns {Object} Result object with connector names
+ */
+async function execute() {
+    try {
+        const { connectors: publicConnectorList } = await developerPortal.getPublicConnectorList();
+        const connectorList = publicConnectorList;
+        if(process.env.RC_ACCOUNT_ID) {
+            const { privateConnectors } = await developerPortal.getPrivateConnectorList();
+            connectorList.push(...privateConnectors);
+        }
+        return {
+            success: true,
+            data: connectorList.map(c => c.displayName)
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message || 'Unknown error occurred',
+            errorDetails: error.stack
+        };
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;

package/mcp/tools/index.js

@@ -0,0 +1,58 @@
+/**
+ * MCP Tools Index
+ * 
+ * This file exports all available MCP tools for the RC Unified CRM Extension.
+ */
+
+// const auth = require('./auth');
+const getHelp = require('./getHelp');
+const getPublicConnectors = require('./getPublicConnectors');
+const setConnector = require('./setConnector');
+const collectAuthInfo = require('./collectAuthInfo');
+const doAuth = require('./doAuth');
+const checkAuthStatus = require('./checkAuthStatus');
+const logout = require('./logout');
+const findContact = require('./findContactByPhone');
+const findContactWithName = require('./findContactByName');
+const getCallLog = require('./getCallLog');
+const createCallLog = require('./createCallLog');
+const updateCallLog = require('./updateCallLog');
+const createMessageLog = require('./createMessageLog');
+const rcGetCallLogs = require('./rcGetCallLogs');
+
+// Export all tools
+module.exports = {
+    getHelp,
+    getPublicConnectors,
+    setConnector,
+    collectAuthInfo,
+    doAuth,
+    checkAuthStatus,
+    logout,
+    findContact,
+    findContactWithName,
+    getCallLog,
+    createCallLog,
+    updateCallLog,
+    createMessageLog,
+    rcGetCallLogs
+};
+
+// Export tools as an array for easy iteration
+module.exports.tools = [
+    getHelp,
+    getPublicConnectors,
+    setConnector,
+    collectAuthInfo,
+    doAuth,
+    checkAuthStatus,
+    logout,
+    findContact,
+    findContactWithName,
+    getCallLog,
+    createCallLog,
+    updateCallLog,
+    createMessageLog,
+    rcGetCallLogs
+];
+

package/mcp/tools/logout.js

@@ -0,0 +1,63 @@
+const jwt = require('../../lib/jwt');
+const { UserModel } = require('../../models/userModel');
+const connectorRegistry = require('../../connector/registry');
+
+/**
+ * MCP Tool: Logout
+ * 
+ * This tool logs out the user from the CRM platform.
+ */
+
+const toolDefinition = {
+    name: 'logout',
+    description: 'Logout the user from the CRM platform.',
+    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.'
+            }
+        }
+    }
+};
+
+/**
+ * Execute the logout tool
+ * @param {Object} args - The tool arguments
+ * @param {string} args.jwtToken - JWT token containing userId and platform information. If user does not have this, direct them to use the "auth" tool first.
+ * @returns {Object} Result object with logout information
+ */
+async function execute(args) {
+    try {
+        const { jwtToken } = args;
+        const { platform, id } = jwt.decodeJwt(jwtToken);
+        
+        const userToLogout = await UserModel.findByPk(id);
+            if (!userToLogout) {
+            return {
+                success: false,
+                error: "User not found",
+                errorDetails: "User not found",
+            };
+        }
+        const platformModule = connectorRegistry.getConnector(platform);
+        await platformModule.unAuthorize({ user: userToLogout });
+        return {
+            success: true,
+            data: {
+                message: "IMPORTANT: Logout successful. Clear jwtToken, connectorManifest, connectorDisplayName, hostname and connectorName in memory. User is logged out from the CRM platform.",
+            }
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message || 'Unknown error occurred',
+            errorDetails: error.stack
+        };
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;

package/mcp/tools/rcGetCallLogs.js

@@ -0,0 +1,73 @@
+const { RingCentral } = require('../../lib/ringcentral');
+const jwt = require('../../lib/jwt');
+const { CallLogModel } = require('../../models/callLogModel');
+
+const toolDefinition = {
+    name: 'rcGetCallLogs',
+    description: '⚠️ REQUIRES AUTHENTICATION: User must first authenticate using the "auth" tool to obtain a JWT token before using this tool. | Get call logs from RingCentral',
+    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.'
+            },
+            timeFrom: {
+                type: 'string',
+                description: 'MUST be ISO string. Default is 24 hours ago.'
+            },
+            timeTo: {
+                type: 'string',
+                description: 'MUST be ISO string. Default is now.'
+            }
+        },
+        required: ['jwtToken', 'timeFrom', 'timeTo']
+    }
+}
+
+async function execute(args) {
+    try {
+        const { jwtToken, rcAccessToken, timeFrom, timeTo } = args;
+        if (!rcAccessToken) {
+            throw new Error('RingCentral access token not found');
+        }
+        const { id: userId } = jwt.decodeJwt(jwtToken);
+        if (!userId) {
+            throw new Error('Invalid JWT token: userId not found');
+        }
+        const rcSDK = new RingCentral({
+            server: process.env.RINGCENTRAL_SERVER,
+            clientId: process.env.RINGCENTRAL_CLIENT_ID,
+            clientSecret: process.env.RINGCENTRAL_CLIENT_SECRET,
+            redirectUri: `${process.env.APP_SERVER}/ringcentral/oauth/callback`
+        });
+        const callLogData = await rcSDK.getCallLogData({
+            token: { access_token: rcAccessToken, token_type: 'Bearer' },
+            timeFrom: timeFrom ?? new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString(),
+            timeTo: timeTo ?? new Date().toISOString(),
+        });
+        // hack: remove already logged calls
+        const existingCalls = [];
+        for (const call of callLogData.records) {
+            const existingCallLog = await CallLogModel.findOne({
+                where: {
+                    sessionId: call.sessionId
+                }
+            });
+            if (existingCallLog) {
+                existingCalls.push(existingCallLog.sessionId);
+            }
+        }
+        callLogData.records = callLogData.records.filter(call => !existingCalls.includes(call.sessionId));
+        return callLogData;
+    }
+    catch (e) {
+        return {
+            success: false,
+            error: e.message
+        }
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;

package/mcp/tools/setConnector.js

@@ -0,0 +1,64 @@
+const developerPortal = require('../../connector/developerPortal');
+
+/**
+ * MCP Tool: Set Connector
+ * 
+ * This tool helps the user set the connector.
+ */
+
+const toolDefinition = {
+    name: 'setConnector',
+    description: 'Auth flow step.2. Save connectorManifest to memory if successful. Next step is optional, if it is oauth, go to step.3 "collectAuthInfo" tool.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            connectorDisplayName: {
+                type: 'string',
+                description: 'Connector displayname to set'
+            }
+        },
+        required: ['connectorDisplayName']
+    }
+};
+
+/**
+ * Execute the setConnector tool
+ * @param {Object} args - The tool arguments
+ * @param {string} args.connectorDisplayName - Connector display name to set
+ * @returns {Object} Result object with connector information
+ */
+async function execute(args) {
+    try {
+        const { connectorDisplayName } = args;
+        const { connectors: publicConnectorList } = await developerPortal.getPublicConnectorList();
+        const { privateConnectors } = await developerPortal.getPrivateConnectorList();
+        const connectorList = [...publicConnectorList, ...privateConnectors];
+        const connector = connectorList.find(c => c.displayName === connectorDisplayName);
+        const connectorName = connector.name;
+        const connectorManifest = await developerPortal.getConnectorManifest({ connectorId: connector.id, isPrivate: connector.status === 'private' });
+        if (!connectorManifest) {
+            throw new Error(`Connector manifest not found: ${connectorDisplayName}`);
+        }
+        return {
+            success: true,
+            data: {
+                connectorManifest,
+                connectorDisplayName,
+                connectorName,
+                // Add explicit instruction
+                message: "IMPORTANT: Use connectorManifest, connectorDisplayName, and connectorName in the next few authentication steps.",
+                
+            }
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message || 'Unknown error occurred',
+            errorDetails: error.stack
+        };
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;

package/mcp/tools/updateCallLog.js

@@ -0,0 +1,122 @@
+const jwt = require('../../lib/jwt');
+const connectorRegistry = require('../../connector/registry');
+const logCore = require('../../handlers/log');
+const util = require('../../lib/util');
+
+/**
+ * MCP Tool: Update Call Log
+ * 
+ * This tool updates an existing call log in the CRM platform.
+ */
+
+const toolDefinition = {
+    name: 'updateCallLog',
+    description: '⚠️ REQUIRES AUTHENTICATION: User must first authenticate using the "auth" tool to obtain a JWT token before using this tool. | Update an existing call log in the CRM platform. Returns the updated log ID if successful.',
+    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.'
+            },
+            incomingData: {
+                type: 'object',
+                description: 'Call log update data including sessionId, note, additionalSubmission, etc.',
+                properties: {
+                    sessionId: {
+                        type: 'string',
+                        description: 'Session ID of the call log to update'
+                    },
+                    note: {
+                        type: 'string',
+                        description: 'Updated call note/description'
+                    },
+                    additionalSubmission: {
+                        type: 'object',
+                        description: 'Additional platform-specific fields to update'
+                    },
+                    accountId: {
+                        type: 'string',
+                        description: 'RingCentral account ID'
+                    }
+                },
+                required: ['sessionId']
+            }
+        },
+        required: ['jwtToken', 'incomingData']
+    }
+};
+
+/**
+ * Execute the updateCallLog tool
+ * @param {Object} args - The tool arguments
+ * @param {string} args.jwtToken - JWT token with user and platform info
+ * @param {Object} args.incomingData - Call log update data
+ * @returns {Object} Result object with updated log ID
+ */
+async function execute(args) {
+    try {
+        const { jwtToken, incomingData } = args;
+        
+        // Decode JWT to get userId and platform
+        const { id: userId, platform } = jwt.decodeJwt(jwtToken);
+        
+        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 updateCallLog is implemented
+        if (!platformModule.updateCallLog) {
+            throw new Error(`updateCallLog is not implemented for platform: ${platform}`);
+        }
+
+        // Calculate hashed account ID
+        const hashedAccountId = incomingData.accountId 
+            ? util.getHashValue(incomingData.accountId, process.env.HASH_KEY) 
+            : undefined;
+
+        // Call the updateCallLog method
+        const { successful, logId, updatedNote, returnMessage } = await logCore.updateCallLog({ 
+            platform, 
+            userId, 
+            incomingData, 
+            hashedAccountId,
+            isFromSSCL: false 
+        });
+        
+        if (successful) {
+            return {
+                success: true,
+                data: {
+                    logId,
+                    updatedNote,
+                    message: returnMessage?.message || 'Call log updated successfully'
+                }
+            };
+        }
+        else {
+            return {
+                success: false,
+                error: returnMessage?.message || 'Failed to update call log',
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message || 'Unknown error occurred',
+            errorDetails: error.stack
+        };
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;
+

package/models/accountDataModel.js

@@ -0,0 +1,34 @@
+const Sequelize = require('sequelize');
+const { sequelize } = require('./sequelize');
+
+// Model for account data with composite primary key
+exports.AccountDataModel = sequelize.define('accountData', {
+    rcAccountId: {
+        type: Sequelize.STRING,
+        primaryKey: true,
+    },
+    platformName: {
+        type: Sequelize.STRING,
+        primaryKey: true,
+    },
+    dataKey: {
+        type: Sequelize.STRING,
+        primaryKey: true,
+    },
+    data: {
+        type: Sequelize.JSON,
+    }
+});
+
+exports.getOrRefreshAccountData = async function getOrRefreshAccountData({ rcAccountId, platformName, dataKey, forceRefresh, fetchFn }) {
+    const existing = await exports.AccountDataModel.findOne({ where: { rcAccountId, platformName, dataKey } });
+    if (existing && !forceRefresh) return existing.data;
+
+    const fresh = await fetchFn();
+    if (existing) {
+        await existing.update({ data: fresh });
+    } else {
+        await exports.AccountDataModel.create({ rcAccountId, platformName, dataKey, data: fresh });
+    }
+    return fresh;
+}

package/models/cacheModel.js

@@ -17,6 +17,9 @@ exports.CacheModel = sequelize.define('cache', {
     cacheKey: {
         type: Sequelize.STRING,
     },
+    data: {
+        type: Sequelize.JSON
+    },
     expiry: {
         type: Sequelize.DATE
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@app-connect/core",
-  "version": "1.7.8",
+  "version": "1.7.11",
   "description": "RingCentral App Connect Core",
   "main": "index.js",
   "repository": {
@@ -15,7 +15,7 @@
   "license": "MIT",
   "peerDependencies": {
     "axios": "^1.12.2",
-    "express": "^4.21.2",
+    "express": "^4.22.1",
     "moment": "^2.29.4",
     "moment-timezone": "^0.5.39",
     "pg": "^8.8.0",
@@ -23,9 +23,11 @@
   },
   "dependencies": {
     "@aws-sdk/client-dynamodb": "^3.751.0",
+    "@modelcontextprotocol/sdk": "^1.21.1",
     "@aws-sdk/client-s3": "^3.947.0",
     "@aws-sdk/s3-request-presigner": "^3.947.0",
-    "body-parser": "^1.20.3",
+    "body-parser": "^1.20.4",
+    "body-parser-xml": "^2.0.5",
     "client-oauth2": "^4.3.3",
     "cors": "^2.8.5",
     "country-state-city": "^3.2.1",
@@ -48,7 +50,7 @@
     "@octokit/rest": "^19.0.5",
     "axios": "^1.12.2",
     "eslint": "^9.22.0",
-    "express": "^4.21.2",
+    "express": "^4.22.1",
     "globals": "^16.0.0",
     "jest": "^29.3.1",
     "moment": "^2.29.4",

package/releaseNotes.json

@@ -1,4 +1,40 @@
 {
+    "1.7.11": {
+        "global": [
+            {
+                "type": "New",
+                "description": "Shared-SMS logging"
+            },
+            {
+                "type": "New",
+                "description": "MCP tools"
+            }
+        ]
+    },
+    "1.7.10": {
+        "global": [
+            {
+                "type": "Fix",
+                "description": "Upon completing warm transfer, it opens contact page for a second time"
+            },
+            {
+                "type": "New",
+                "description": "RingCX RingSense call logging event support for Server-side logging"
+            }
+        ]
+    },
+    "1.7.9": {
+        "global": [
+            {
+                "type": "Better",
+                "description": "Contact match speed optimized"
+            },
+            {
+                "type": "Better",
+                "description": "Minor improvements on calldown list"
+            }
+        ]
+    },
     "1.7.8": {
         "global": [
             {