@app-connect/core 1.7.37 → 1.7.38

package/{mcp → dist/mcp}/tools/getCallLog.js

@@ -1,13 +1,14 @@
-const jwt = require('../../lib/jwt');
-const connectorRegistry = require('../../connector/registry');
-const logCore = require('../../handlers/log');
-
+"use strict";
+// @ts-check
+Object.defineProperty(exports, "__esModule", { value: true });
+const jwt = /** @type {any} */ (require('../../lib/jwt'));
+const connectorRegistry = /** @type {any} */ (require('../../connector/registry'));
+const logCore = /** @type {any} */ (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.',
@@ -35,7 +36,6 @@ const toolDefinition = {
         required: ['jwtToken', 'sessionIds']
     }
 };
-
 /**
  * Execute the getCallLog tool
  * @param {Object} args - The tool arguments
@@ -43,47 +43,40 @@ const toolDefinition = {
  * @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
+ * @returns {Promise<any>} 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 
+            userId,
+            sessionIds,
+            platform,
+            requireDetails
         };
         if (extensionNumber) {
             getCallLogParams.extensionNumber = extensionNumber;
         }
         const { successful, logs, returnMessage } = await logCore.getCallLog(getCallLogParams);
-        
         if (successful) {
             return {
                 success: true,
@@ -105,7 +98,5 @@ async function execute(args) {
         };
     }
 }
-
 exports.definition = toolDefinition;
 exports.execute = execute;
-

package/dist/mcp/tools/getGoogleFilePicker.d.ts

@@ -0,0 +1 @@
+export {};

package/{mcp → dist/mcp}/tools/getGoogleFilePicker.js

@@ -1,14 +1,16 @@
-const jwt = require('../../lib/jwt');
-const { UserModel } = require('../../models/userModel');
-const axios = require('axios');
-
+"use strict";
+// @ts-check
+Object.defineProperty(exports, "__esModule", { value: true });
+const jwt = /** @type {any} */ (require('../../lib/jwt'));
+const { UserModel: RawUserModel } = require('../../models/userModel');
+const UserModel = /** @type {any} */ (RawUserModel);
+const axios = /** @type {any} */ (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.',
@@ -28,46 +30,38 @@ const toolDefinition = {
         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
+ * @returns {Promise<any>} 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;
@@ -75,7 +69,6 @@ async function execute(args) {
         else {
             // Generate the file picker URL
             const filePickerUrl = `${process.env.APP_SERVER}/googleSheets/filePicker?token=${jwtToken}`;
-
             return {
                 success: true,
                 data: {
@@ -93,7 +86,5 @@ async function execute(args) {
         };
     }
 }
-
 exports.definition = toolDefinition;
 exports.execute = execute;
-

package/dist/mcp/tools/getHelp.d.ts

@@ -0,0 +1 @@
+export {};

package/{mcp → dist/mcp}/tools/getHelp.js

@@ -1,10 +1,12 @@
+"use strict";
+// @ts-check
+Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * 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.',
@@ -19,10 +21,9 @@ const toolDefinition = {
         destructiveHint: false
     }
 };
-
 /**
  * Execute the getHelp tool
- * @returns {Object} Result object with help information
+ * @returns {Promise<any>} Result object with help information
  */
 async function execute() {
     return {
@@ -37,7 +38,5 @@ async function execute() {
         }
     };
 }
-
 exports.definition = toolDefinition;
 exports.execute = execute;
-

package/dist/mcp/tools/getPublicConnectors.d.ts

@@ -0,0 +1 @@
+export {};

package/{mcp → dist/mcp}/tools/getPublicConnectors.js

@@ -1,8 +1,14 @@
-const axios = require('axios');
-const { Op } = require('sequelize');
-const { UserModel } = require('../../models/userModel');
-const { getHashValue } = require('../../lib/util');
-
+"use strict";
+// @ts-check
+Object.defineProperty(exports, "__esModule", { value: true });
+const axios = /** @type {any} */ (require('axios'));
+const { Op } = /** @type {any} */ (require('sequelize'));
+const { UserModel: RawUserModel } = require('../../models/userModel');
+const UserModel = /** @type {any} */ (RawUserModel);
+const { getHashValue: rawGetHashValue } = require('../../lib/util');
+const getHashValue = /** @type {any} */ (rawGetHashValue);
+const { createWidgetSessionToken: rawCreateWidgetSessionToken } = require('../lib/widgetSessionToken');
+const createWidgetSessionToken = /** @type {any} */ (rawCreateWidgetSessionToken);
 /**
  * MCP Tool: Get Public Connectors
  *
@@ -11,7 +17,6 @@ const { getHashValue } = require('../../lib/util');
  * This tool only needs to resolve the RC account ID (for private connector
  * support) and return the server URL for widget-to-server tool calls.
  */
-
 const toolDefinition = {
     name: 'getPublicConnectors',
     description: 'Get available connectors. Returns an interactive widget - do NOT summarize or list the results in text, just show the widget.',
@@ -26,35 +31,32 @@ const toolDefinition = {
         destructiveHint: false
     },
     _meta: {
-        // openai/outputTemplate is injected at registration time by mcpHandler.js
+        // openai/outputTemplate is injected at registration time by mcpHandler.ts
         // using the module-level WIDGET_URI — do not hardcode a version here.
         "openai/toolBehavior": 'interactive',
         "openai/widgetAccessible": true
     }
 };
-
 /**
  * Execute the getPublicConnectors tool.
  * Uses the RC access token (injected by mcpHandler) to resolve the account ID,
  * which the widget needs to fetch private connectors directly from the developer portal.
+ * @param {{ rcAccessToken?: string, openaiSessionId?: string }=} params - Injected MCP session parameters
+ * @returns {Promise<any>} Result object with connector metadata
  */
 async function execute({ rcAccessToken, openaiSessionId } = {}) {
     let rcExtensionId = null;
     let rcAccountId = null;
-
     if (rcAccessToken) {
         try {
-            const resp = await axios.get(
-                'https://platform.ringcentral.com/restapi/v1.0/account/~/extension/~',
-                { headers: { Authorization: `Bearer ${rcAccessToken}` } }
-            );
+            const resp = await axios.get('https://platform.ringcentral.com/restapi/v1.0/account/~/extension/~', { headers: { Authorization: `Bearer ${rcAccessToken}` } });
             rcExtensionId = resp.data?.id ?? null;
             rcAccountId = resp.data?.account?.id ?? null;
-        } catch {
+        }
+        catch {
             // Non-fatal: widget will only show public connectors
         }
     }
-
     // Check if user session already exists from Chrome extension
     const hashedRcExtensionId = getHashValue(rcExtensionId, process.env.HASH_KEY);
     const user = await UserModel.findOne({
@@ -74,7 +76,7 @@ async function execute({ rcAccessToken, openaiSessionId } = {}) {
                 error: true,
                 errorMessage: `You are already connected to ${user.platform}. It's controlled from App Connect Chrome extension.`
             }
-        }
+        };
     }
     else {
         // Case: user doesn't exist, return structured content for widget
@@ -84,11 +86,10 @@ async function execute({ rcAccessToken, openaiSessionId } = {}) {
                 rcExtensionId,
                 rcAccountId,
                 openaiSessionId: openaiSessionId ?? null,
+                widgetSessionToken: createWidgetSessionToken({ rcExtensionId, openaiSessionId: openaiSessionId ?? null }),
             }
         };
     }
-
 }
-
 exports.definition = toolDefinition;
 exports.execute = execute;

package/dist/mcp/tools/getSessionInfo.d.ts

@@ -0,0 +1 @@
+export {};

package/{mcp → dist/mcp}/tools/getSessionInfo.js

@@ -1,13 +1,16 @@
-const jwt = require('../../lib/jwt');
-const { UserModel } = require('../../models/userModel');
-const { RingCentral } = require('../../lib/ringcentral');
-
+"use strict";
+// @ts-check
+Object.defineProperty(exports, "__esModule", { value: true });
+const jwt = /** @type {any} */ (require('../../lib/jwt'));
+const { UserModel: RawUserModel } = require('../../models/userModel');
+const UserModel = /** @type {any} */ (RawUserModel);
+const { RingCentral: RawRingCentral } = require('../../lib/ringcentral');
+const RingCentral = /** @type {any} */ (RawRingCentral);
 /**
  * MCP Tool: Get Session Info
  *
  * Returns non-sensitive information about the current MCP/CRM session.
  */
-
 const toolDefinition = {
     name: 'getSessionInfo',
     description: 'Get the current user session info, including RingCentral identity and CRM connection status.',
@@ -22,7 +25,6 @@ const toolDefinition = {
         destructiveHint: false
     }
 };
-
 /**
  * Execute the getSessionInfo tool
  * @param {Object} args - Tool arguments injected by mcpHandler
@@ -30,21 +32,14 @@ const toolDefinition = {
  * @param {string} [args.rcExtensionId] - Verified RingCentral extension identifier
  * @param {string} [args.jwtToken] - CRM JWT token
  * @param {string} [args.rcAccessToken] - RingCentral access token
- * @returns {Object} Result object with session information
+ * @returns {Promise<any>} Result object with session information
  */
 async function execute(args = {}) {
     try {
-        const {
-            openaiSessionId = null,
-            rcExtensionId = null,
-            jwtToken,
-            rcAccessToken,
-        } = args;
-
+        const { openaiSessionId = null, rcExtensionId = null, jwtToken, rcAccessToken, } = args;
         const decodedToken = jwtToken ? jwt.decodeJwt(jwtToken) : null;
         const userId = decodedToken?.id ?? null;
         const user = userId ? await UserModel.findByPk(userId) : null;
-
         let rcExtensionInfo = null;
         if (rcExtensionId && rcAccessToken) {
             const rcSDK = new RingCentral({
@@ -85,6 +80,5 @@ async function execute(args = {}) {
         };
     }
 }
-
 exports.definition = toolDefinition;
 exports.execute = execute;

package/dist/mcp/tools/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Tools Index
+ *
+ * Two separate registries:
+ *  - tools:       Registered in the MCP server — visible to and callable by the AI model
+ *  - widgetTools: Only accessible via POST /mcp/widget-tool-call — hidden from the AI model
+ */
+export {};

package/dist/mcp/tools/index.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * MCP Tools Index
+ *
+ * Two separate registries:
+ *  - tools:       Registered in the MCP server — visible to and callable by the AI model
+ *  - widgetTools: Only accessible via POST /mcp/widget-tool-call — hidden from the AI model
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+// @ts-check
+const getHelp = /** @type {any} */ (require('./getHelp'));
+const getPublicConnectors = /** @type {any} */ (require('./getPublicConnectors'));
+const getSessionInfo = /** @type {any} */ (require('./getSessionInfo'));
+const doAuth = /** @type {any} */ (require('./doAuth'));
+const checkAuthStatus = /** @type {any} */ (require('./checkAuthStatus'));
+const logout = /** @type {any} */ (require('./logout'));
+const findContact = /** @type {any} */ (require('./findContactByPhone'));
+const findContactWithName = /** @type {any} */ (require('./findContactByName'));
+const createCallLog = /** @type {any} */ (require('./createCallLog'));
+const rcGetCallLogs = /** @type {any} */ (require('./rcGetCallLogs'));
+// const getGoogleFilePicker = require('./getGoogleFilePicker');
+const createContact = /** @type {any} */ (require('./createContact'));
+const createAppointment = /** @type {any} */ (require('./createAppointment'));
+const updateAppointment = /** @type {any} */ (require('./updateAppointment'));
+const confirmAppointment = /** @type {any} */ (require('./confirmAppointment'));
+const cancelAppointment = /** @type {any} */ (require('./cancelAppointment'));
+const listAppointments = /** @type {any} */ (require('./listAppointments'));
+// AI-visible MCP tools — registered in the MCP server
+module.exports.tools = [
+    getHelp,
+    getPublicConnectors,
+    getSessionInfo,
+    logout,
+    findContact,
+    findContactWithName,
+    createCallLog,
+    rcGetCallLogs,
+    // getGoogleFilePicker,
+    createContact,
+    listAppointments,
+    createAppointment,
+    updateAppointment,
+    confirmAppointment,
+    cancelAppointment,
+];
+// Widget-only tools — callable via /mcp/widget-tool-call, NOT registered as MCP tools
+module.exports.widgetTools = [
+    doAuth,
+    checkAuthStatus,
+];

package/dist/mcp/tools/listAppointments.d.ts

@@ -0,0 +1 @@
+export {};

package/{mcp → dist/mcp}/tools/listAppointments.js

@@ -1,14 +1,15 @@
-const jwt = require('../../lib/jwt');
-const connectorRegistry = require('../../connector/registry');
-const appointmentCore = require('../../handlers/appointment');
-
+"use strict";
+// @ts-check
+Object.defineProperty(exports, "__esModule", { value: true });
+const jwt = /** @type {any} */ (require('../../lib/jwt'));
+const connectorRegistry = /** @type {any} */ (require('../../connector/registry'));
+const appointmentCore = /** @type {any} */ (require('../../handlers/appointment'));
 /**
  * MCP Tool: List Appointments
  *
  * Fetches appointments/events from the CRM platform.
  * Accepts a named filter (upcoming, today, past, all) or a custom date range.
  */
-
 const toolDefinition = {
     name: 'listAppointments',
     description: '⚠️ REQUIRES CRM CONNECTION. | List appointments or events from the CRM platform. Use the `filter` param to get upcoming, today\'s, past, or all appointments. For a specific window, supply `startDate` and `endDate` (YYYY-MM-DD) directly.',
@@ -48,7 +49,6 @@ const toolDefinition = {
         destructiveHint: false
     }
 };
-
 /**
  * Build a YYYY-MM-DD string offset by `days` from today.
  */
@@ -57,11 +57,9 @@ function offsetDate(days) {
     d.setDate(d.getDate() + days);
     return d.toISOString().slice(0, 10);
 }
-
 function todayStr() {
     return new Date().toISOString().slice(0, 10);
 }
-
 /**
  * Resolve the range object from the filter name or explicit dates.
  */
@@ -84,7 +82,6 @@ function resolveRange({ filter, startDate, endDate }) {
             return { startDate: offsetDate(-90), endDate: offsetDate(90) };
     }
 }
-
 /**
  * Execute the listAppointments tool
  * @param {Object} args
@@ -93,37 +90,30 @@ function resolveRange({ filter, startDate, endDate }) {
  * @param {string} [args.startDate] - Custom range start (YYYY-MM-DD), used when filter="custom"
  * @param {string} [args.endDate] - Custom range end (YYYY-MM-DD), used when filter="custom"
  * @param {boolean} [args.mineOnly] - Restrict to the current user's appointments
- * @returns {Object} Result with appointment list
+ * @returns {Promise<any>} Result with appointment list
  */
 async function execute(args) {
     try {
         const { jwtToken, filter, startDate, endDate, mineOnly } = args;
-
         if (!jwtToken) {
             throw new Error('Please go to Settings and authorize CRM 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');
         }
-
         const platformModule = connectorRegistry.getConnector(platform);
         if (!platformModule) {
             throw new Error(`Platform connector not found for: ${platform}`);
         }
-
         if (!platformModule.listAppointments) {
             throw new Error(`listAppointments is not implemented for platform: ${platform}`);
         }
-
         const range = resolveRange({ filter, startDate, endDate });
-
         const { successful, appointments, returnMessage } = await appointmentCore.listAppointments({
             platform,
             userId,
@@ -131,7 +121,6 @@ async function execute(args) {
             mineOnly: mineOnly ?? false,
             forceSync: false
         });
-
         if (successful) {
             return {
                 success: true,
@@ -158,6 +147,5 @@ async function execute(args) {
         };
     }
 }
-
 exports.definition = toolDefinition;
 exports.execute = execute;

package/dist/mcp/tools/logout.d.ts

@@ -0,0 +1 @@
+export {};

package/{mcp → dist/mcp}/tools/logout.js

@@ -1,17 +1,20 @@
-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');
-
+"use strict";
+// @ts-check
+Object.defineProperty(exports, "__esModule", { value: true });
+const jwt = /** @type {any} */ (require('../../lib/jwt'));
+const { UserModel: RawUserModel } = require('../../models/userModel');
+const UserModel = /** @type {any} */ (RawUserModel);
+const { LlmSessionModel: RawLlmSessionModel } = require('../../models/llmSessionModel');
+const LlmSessionModel = /** @type {any} */ (RawLlmSessionModel);
+const { CacheModel: RawCacheModel } = require('../../models/cacheModel');
+const CacheModel = /** @type {any} */ (RawCacheModel);
+const connectorRegistry = /** @type {any} */ (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.',
@@ -25,19 +28,19 @@ const toolDefinition = {
         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
+ * @param {string} [args.rcExtensionId] - Optional RC extension session ID injected by the MCP handler
+ * @param {string} [args.openaiSessionId] - Optional OpenAI session ID injected by the MCP handler
+ * @returns {Promise<any>} Result object with logout information
  */
 async function execute(args) {
     try {
@@ -84,7 +87,7 @@ async function execute(args) {
             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 {
@@ -94,6 +97,5 @@ async function execute(args) {
         };
     }
 }
-
 exports.definition = toolDefinition;
 exports.execute = execute;

package/dist/mcp/tools/rcGetCallLogs.d.ts

@@ -0,0 +1 @@
+export {};

package/{mcp → dist/mcp}/tools/rcGetCallLogs.js

@@ -1,7 +1,11 @@
-const { RingCentral } = require('../../lib/ringcentral');
-const jwt = require('../../lib/jwt');
-const { CallLogModel } = require('../../models/callLogModel');
-
+"use strict";
+// @ts-check
+Object.defineProperty(exports, "__esModule", { value: true });
+const { RingCentral: RawRingCentral } = require('../../lib/ringcentral');
+const RingCentral = /** @type {any} */ (RawRingCentral);
+const jwt = /** @type {any} */ (require('../../lib/jwt'));
+const { CallLogModel: RawCallLogModel } = require('../../models/callLogModel');
+const CallLogModel = /** @type {any} */ (RawCallLogModel);
 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.',
@@ -24,8 +28,7 @@ const toolDefinition = {
         openWorldHint: true,
         destructiveHint: false
     }
-}
-
+};
 async function execute(args) {
     try {
         const { jwtToken, rcAccessToken, timeFrom, timeTo } = args;
@@ -57,9 +60,8 @@ async function execute(args) {
         return {
             success: false,
             error: e.message
-        }
+        };
     }
 }
-
 exports.definition = toolDefinition;
 exports.execute = execute;

package/dist/mcp/tools/updateAppointment.d.ts

@@ -0,0 +1 @@
+export {};