@app-connect/core 1.7.25 → 1.7.27

package/mcp/tools/logout.js

@@ -1,96 +1,99 @@
-const jwt = require('../../lib/jwt');
-const { UserModel } = require('../../models/userModel');
-const { LlmSessionModel } = require('../../models/llmSessionModel');
-const { CacheModel } = require('../../models/cacheModel');
-const connectorRegistry = require('../../connector/registry');
-
-const RC_EXTENSION_CACHE_KEY = 'rcExtensionId';
-
-/**
- * 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: {}
-    },
-    annotations: {
-        readOnlyHint: false,
-        openWorldHint: true,
-        destructiveHint: true
-    }
-};
-
-function isMissingSessionTableError(error) {
-    const message = error?.message || '';
-    return message.includes('no such table: llmSessions')
-        || message.includes('relation "llmSessions" does not exist')
-        || message.includes("relation 'llmSessions' does not exist");
-}
-
-/**
- * Execute the logout tool
- * @param {Object} args - The tool arguments
- * @param {string} args.jwtToken - JWT token containing userId and platform information. Injected automatically by the server after CRM connection.
- * @returns {Object} Result object with logout information
- */
-async function execute(args) {
-    try {
-        const { jwtToken, rcExtensionId, openaiSessionId } = args;
-        const session = jwt.decodeJwt(jwtToken);
-        if (!session?.platform || !session?.id) {
-            throw new Error('Invalid JWT token');
-        }
-        const { platform, id } = session;
-        try {
-            await LlmSessionModel.destroy({ where: { id } });
-            if (rcExtensionId && rcExtensionId !== id) {
-                await LlmSessionModel.destroy({ where: { id: rcExtensionId } });
-            }
-            if (openaiSessionId) {
-                await CacheModel.destroy({ where: { id: `${openaiSessionId}-${RC_EXTENSION_CACHE_KEY}` } });
-            }
-        }
-        catch (error) {
-            if (!isMissingSessionTableError(error)) {
-                throw error;
-            }
-        }
-        const userToLogout = await UserModel.findByPk(id);
-        if (!userToLogout) {
-            return {
-                success: false,
-                error: "User not found",
-                errorDetails: "User not found",
-            };
-        }
-        const platformModule = connectorRegistry.getConnector(platform);
-        try {
-            await platformModule.unAuthorize({ user: userToLogout });
-        }
-        catch (error) {
-            console.log(error);
-        }
-        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;
+const jwt = require('../../lib/jwt');
+const { UserModel } = require('../../models/userModel');
+const { LlmSessionModel } = require('../../models/llmSessionModel');
+const { CacheModel } = require('../../models/cacheModel');
+const connectorRegistry = require('../../connector/registry');
+
+const RC_EXTENSION_CACHE_KEY = 'rcExtensionId';
+
+/**
+ * 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: {}
+    },
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: true,
+        destructiveHint: true
+    }
+};
+
+function isMissingSessionTableError(error) {
+    const message = error?.message || '';
+    return message.includes('no such table: llmSessions')
+        || message.includes('relation "llmSessions" does not exist')
+        || message.includes("relation 'llmSessions' does not exist");
+}
+
+/**
+ * Execute the logout tool
+ * @param {Object} args - The tool arguments
+ * @param {string} args.jwtToken - JWT token containing userId and platform information. Injected automatically by the server after CRM connection.
+ * @returns {Object} Result object with logout information
+ */
+async function execute(args) {
+    try {
+        const { jwtToken, rcExtensionId, openaiSessionId } = args;
+        const session = jwt.decodeJwt(jwtToken);
+        if (!session?.platform || !session?.id) {
+            throw new Error('Invalid JWT token');
+        }
+        const { platform, id } = session;
+        try {
+            await LlmSessionModel.destroy({ where: { id } });
+            if (rcExtensionId && rcExtensionId !== id) {
+                await LlmSessionModel.destroy({ where: { id: rcExtensionId } });
+            }
+            if (openaiSessionId) {
+                await CacheModel.destroy({ where: { id: `${openaiSessionId}-${RC_EXTENSION_CACHE_KEY}` } });
+            }
+        }
+        catch (error) {
+            if (!isMissingSessionTableError(error)) {
+                throw error;
+            }
+        }
+        const userToLogout = await UserModel.findByPk(id);
+        if (!userToLogout) {
+            return {
+                success: false,
+                error: "User not found",
+                errorDetails: "User not found",
+            };
+        }
+        const platformModule = connectorRegistry.getConnector(platform);
+        try {
+            const logoutResult = await platformModule.unAuthorize({ user: userToLogout });
+            if (!logoutResult.successful) {
+                throw new Error(logoutResult.returnMessage.message);
+            }
+        }
+        catch (error) {
+            console.log(error);
+        }
+        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

@@ -1,65 +1,65 @@
-const { RingCentral } = require('../../lib/ringcentral');
-const jwt = require('../../lib/jwt');
-const { CallLogModel } = require('../../models/callLogModel');
-
-const toolDefinition = {
-    name: 'rcGetCallLogs',
-    description: '⚠️ REQUIRES CRM CONNECTION. | Get call logs from RingCentral. Returns a `records[]` array. Each item in `records` is a complete RingCentral call log object that can be passed DIRECTLY as `incomingData.logInfo` to the `createCallLog` tool — no field renaming or restructuring needed.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            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: []
-    },
-    annotations: {
-        readOnlyHint: true,
-        openWorldHint: true,
-        destructiveHint: false
-    }
-}
-
-async function execute(args) {
-    try {
-        const { jwtToken, rcAccessToken, timeFrom, timeTo } = args;
-        if (!rcAccessToken) {
-            throw new Error('RingCentral access token not found');
-        }
-        const decodedToken = jwt.decodeJwt(jwtToken);
-        if (!decodedToken) {
-            throw new Error('Invalid JWT token');
-        }
-        const { id: userId } = decodedToken;
-        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(),
-        });
-        return callLogData;
-    }
-    catch (e) {
-        return {
-            success: false,
-            error: e.message
-        }
-    }
-}
-
-exports.definition = toolDefinition;
-exports.execute = execute;
+const { RingCentral } = require('../../lib/ringcentral');
+const jwt = require('../../lib/jwt');
+const { CallLogModel } = require('../../models/callLogModel');
+
+const toolDefinition = {
+    name: 'rcGetCallLogs',
+    description: '⚠️ REQUIRES CRM CONNECTION. | Get call logs from RingCentral. Returns a `records[]` array. Each item in `records` is a complete RingCentral call log object that can be passed DIRECTLY as `incomingData.logInfo` to the `createCallLog` tool — no field renaming or restructuring needed.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            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: []
+    },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+        destructiveHint: false
+    }
+}
+
+async function execute(args) {
+    try {
+        const { jwtToken, rcAccessToken, timeFrom, timeTo } = args;
+        if (!rcAccessToken) {
+            throw new Error('RingCentral access token not found');
+        }
+        const decodedToken = jwt.decodeJwt(jwtToken);
+        if (!decodedToken) {
+            throw new Error('Invalid JWT token');
+        }
+        const { id: userId } = decodedToken;
+        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(),
+        });
+        return callLogData;
+    }
+    catch (e) {
+        return {
+            success: false,
+            error: e.message
+        }
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;

package/mcp/tools/updateAppointment.js

@@ -0,0 +1,154 @@
+const jwt = require('../../lib/jwt');
+const connectorRegistry = require('../../connector/registry');
+const appointmentCore = require('../../handlers/appointment');
+
+/**
+ * MCP Tool: Update Appointment
+ *
+ * Updates (reschedules or edits) an existing appointment/event in the CRM platform.
+ */
+
+const toolDefinition = {
+    name: 'updateAppointment',
+    description: '⚠️ REQUIRES CRM CONNECTION. | Update or reschedule an existing appointment or event in the CRM platform. Provide only the fields you want to change alongside the appointmentId.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            appointmentId: {
+                type: 'string',
+                description: 'The CRM appointment or event ID to update.'
+            },
+            title: {
+                type: 'string',
+                description: 'New title or subject for the appointment.'
+            },
+            summary: {
+                type: 'string',
+                description: 'New description or notes for the appointment.'
+            },
+            startTimeUtc: {
+                type: 'string',
+                description: 'New start date and time in ISO 8601 UTC format (e.g. "2026-05-10T15:00:00Z"). Required when rescheduling.'
+            },
+            durationMinutes: {
+                type: 'number',
+                description: 'New duration in minutes. Required when rescheduling.'
+            },
+            contacts: {
+                type: 'array',
+                description: 'Updated list of CRM contact IDs to invite as attendees. Replaces the existing attendee list. Omit to leave attendees unchanged.',
+                items: {
+                    oneOf: [
+                        {
+                            type: 'string',
+                            description: 'CRM contact ID'
+                        },
+                        {
+                            type: 'object',
+                            description: 'Contact object with id field',
+                            properties: {
+                                id: {
+                                    type: 'string',
+                                    description: 'CRM contact ID'
+                                }
+                            },
+                            required: ['id']
+                        }
+                    ]
+                }
+            }
+        },
+        required: ['appointmentId']
+    },
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: true,
+        destructiveHint: false
+    }
+};
+
+/**
+ * Execute the updateAppointment tool
+ * @param {Object} args
+ * @param {string} args.jwtToken - Injected server-side JWT token
+ * @param {string} args.appointmentId - CRM appointment ID to update
+ * @param {string} [args.title] - New appointment title
+ * @param {string} [args.summary] - New appointment description
+ * @param {string} [args.startTimeUtc] - New ISO 8601 UTC start time
+ * @param {number} [args.durationMinutes] - New duration in minutes
+ * @param {Array}  [args.contacts] - Updated attendee contact IDs
+ * @returns {Object} Result with updated appointment data
+ */
+async function execute(args) {
+    try {
+        const { jwtToken, appointmentId, title, summary, startTimeUtc, durationMinutes, contacts } = args;
+
+        if (!jwtToken) {
+            throw new Error('Please go to Settings and authorize CRM platform');
+        }
+
+        if (!appointmentId) {
+            throw new Error('appointmentId is required');
+        }
+
+        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');
+        }
+
+        const platformModule = connectorRegistry.getConnector(platform);
+        if (!platformModule) {
+            throw new Error(`Platform connector not found for: ${platform}`);
+        }
+
+        if (!platformModule.updateAppointment) {
+            throw new Error(`updateAppointment is not implemented for platform: ${platform}`);
+        }
+
+        // Build the patch body from only the fields the caller supplied
+        const patchBody = {};
+        if (title !== undefined) patchBody.title = title;
+        if (summary !== undefined) patchBody.summary = summary;
+        if (startTimeUtc !== undefined) patchBody.startTimeUtc = startTimeUtc;
+        if (durationMinutes !== undefined) patchBody.durationMinutes = Number(durationMinutes);
+        if (contacts !== undefined) patchBody.contacts = contacts;
+
+        const { successful, appointment, returnMessage } = await appointmentCore.updateAppointment({
+            platform,
+            userId,
+            appointmentId,
+            patchBody
+        });
+
+        if (successful) {
+            return {
+                success: true,
+                data: {
+                    appointment,
+                    message: returnMessage?.message || 'Appointment updated successfully'
+                }
+            };
+        }
+        else {
+            return {
+                success: false,
+                error: returnMessage?.message || 'Failed to update appointment'
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message || 'Unknown error occurred',
+            errorDetails: error.stack
+        };
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;