@app-connect/core 1.7.24 → 1.7.26

package/mcp/tools/getPublicConnectors.js

@@ -1,94 +1,94 @@
-const axios = require('axios');
-const { Op } = require('sequelize');
-const { UserModel } = require('../../models/userModel');
-const { getHashValue } = require('../../lib/util');
-
-/**
- * MCP Tool: Get Public Connectors
- *
- * Triggers the connector selection widget. The widget fetches the connector
- * list and manifests directly from the developer portal on the client side.
- * 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.',
-    inputSchema: {
-        type: 'object',
-        properties: {},
-        required: []
-    },
-    annotations: {
-        readOnlyHint: true,
-        openWorldHint: true,
-        destructiveHint: false
-    },
-    _meta: {
-        // openai/outputTemplate is injected at registration time by mcpHandler.js
-        // 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.
- */
-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}` } }
-            );
-            rcExtensionId = resp.data?.id ?? null;
-            rcAccountId = resp.data?.account?.id ?? null;
-        } 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({
-        where: {
-            hashedRcExtensionId,
-            [Op.and]: [
-                { accessToken: { [Op.not]: null } },
-                { accessToken: { [Op.ne]: '' } },
-            ],
-        },
-        order: [['updatedAt', 'DESC']],
-    });
-    // Case: user exists, return user info in plain message
-    if (user?.accessToken) {
-        return {
-            structuredContent: {
-                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
-        return {
-            structuredContent: {
-                serverUrl: process.env.APP_SERVER || 'https://localhost:6066',
-                rcExtensionId,
-                rcAccountId,
-                openaiSessionId: openaiSessionId ?? null,
-            }
-        };
-    }
-
-}
-
-exports.definition = toolDefinition;
-exports.execute = execute;
+const axios = require('axios');
+const { Op } = require('sequelize');
+const { UserModel } = require('../../models/userModel');
+const { getHashValue } = require('../../lib/util');
+
+/**
+ * MCP Tool: Get Public Connectors
+ *
+ * Triggers the connector selection widget. The widget fetches the connector
+ * list and manifests directly from the developer portal on the client side.
+ * 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.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
+    },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+        destructiveHint: false
+    },
+    _meta: {
+        // openai/outputTemplate is injected at registration time by mcpHandler.js
+        // 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.
+ */
+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}` } }
+            );
+            rcExtensionId = resp.data?.id ?? null;
+            rcAccountId = resp.data?.account?.id ?? null;
+        } 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({
+        where: {
+            hashedRcExtensionId,
+            [Op.and]: [
+                { accessToken: { [Op.not]: null } },
+                { accessToken: { [Op.ne]: '' } },
+            ],
+        },
+        order: [['updatedAt', 'DESC']],
+    });
+    // Case: user exists, return user info in plain message
+    if (user?.accessToken) {
+        return {
+            structuredContent: {
+                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
+        return {
+            structuredContent: {
+                serverUrl: process.env.APP_SERVER || 'https://localhost:6066',
+                rcExtensionId,
+                rcAccountId,
+                openaiSessionId: openaiSessionId ?? null,
+            }
+        };
+    }
+
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;

package/mcp/tools/getSessionInfo.js

@@ -1,90 +1,90 @@
-const jwt = require('../../lib/jwt');
-const { UserModel } = require('../../models/userModel');
-const { RingCentral } = require('../../lib/ringcentral');
-
-/**
- * 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.',
-    inputSchema: {
-        type: 'object',
-        properties: {},
-        required: []
-    },
-    annotations: {
-        readOnlyHint: true,
-        openWorldHint: false,
-        destructiveHint: false
-    }
-};
-
-/**
- * Execute the getSessionInfo tool
- * @param {Object} args - Tool arguments injected by mcpHandler
- * @param {string} [args.openaiSessionId] - OpenAI session identifier
- * @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
- */
-async function execute(args = {}) {
-    try {
-        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({
-                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`
-            });
-            rcExtensionInfo = await rcSDK.getExtensionInfo(rcExtensionId, {
-                access_token: rcAccessToken,
-                token_type: 'Bearer'
-            });
-        }
-        return {
-            success: true,
-            data: {
-                openaiSessionId,
-                dataToShow: {
-                    isCrmAuthenticated: Boolean(decodedToken && user?.accessToken),
-                    ringcentral: {
-                        extensionId: rcExtensionId ?? null,
-                        name: rcExtensionInfo?.name ?? null,
-                    },
-                    crm: {
-                        userId,
-                        platform: decodedToken?.platform ?? user?.platform ?? null,
-                        hostname: user?.hostname ?? null
-                    }
-                }
-            }
-        };
-    }
-    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 { RingCentral } = require('../../lib/ringcentral');
+
+/**
+ * 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.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
+    },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false
+    }
+};
+
+/**
+ * Execute the getSessionInfo tool
+ * @param {Object} args - Tool arguments injected by mcpHandler
+ * @param {string} [args.openaiSessionId] - OpenAI session identifier
+ * @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
+ */
+async function execute(args = {}) {
+    try {
+        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({
+                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`
+            });
+            rcExtensionInfo = await rcSDK.getExtensionInfo(rcExtensionId, {
+                access_token: rcAccessToken,
+                token_type: 'Bearer'
+            });
+        }
+        return {
+            success: true,
+            data: {
+                openaiSessionId,
+                dataToShow: {
+                    isCrmAuthenticated: Boolean(decodedToken && user?.accessToken),
+                    ringcentral: {
+                        extensionId: rcExtensionId ?? null,
+                        name: rcExtensionInfo?.name ?? null,
+                    },
+                    crm: {
+                        userId,
+                        platform: decodedToken?.platform ?? user?.platform ?? null,
+                        hostname: user?.hostname ?? null
+                    }
+                }
+            }
+        };
+    }
+    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

@@ -1,41 +1,51 @@
-/**
- * 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
- */
-
-const getHelp = require('./getHelp');
-const getPublicConnectors = require('./getPublicConnectors');
-const getSessionInfo = require('./getSessionInfo');
-const doAuth = require('./doAuth');
-const checkAuthStatus = require('./checkAuthStatus');
-const logout = require('./logout');
-const findContact = require('./findContactByPhone');
-const findContactWithName = require('./findContactByName');
-const createCallLog = require('./createCallLog');
-const rcGetCallLogs = require('./rcGetCallLogs');
-// const getGoogleFilePicker = require('./getGoogleFilePicker');
-const createContact = require('./createContact');
-
-// AI-visible MCP tools — registered in the MCP server
-module.exports.tools = [
-    getHelp,
-    getPublicConnectors,
-    getSessionInfo,
-    logout,
-    findContact,
-    findContactWithName,
-    createCallLog,
-    rcGetCallLogs,
-    // getGoogleFilePicker,
-    createContact,
-];
-
-// Widget-only tools — callable via /mcp/widget-tool-call, NOT registered as MCP tools
-module.exports.widgetTools = [
-    doAuth,
-    checkAuthStatus,
-];
-
+/**
+ * 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
+ */
+
+const getHelp = require('./getHelp');
+const getPublicConnectors = require('./getPublicConnectors');
+const getSessionInfo = require('./getSessionInfo');
+const doAuth = require('./doAuth');
+const checkAuthStatus = require('./checkAuthStatus');
+const logout = require('./logout');
+const findContact = require('./findContactByPhone');
+const findContactWithName = require('./findContactByName');
+const createCallLog = require('./createCallLog');
+const rcGetCallLogs = require('./rcGetCallLogs');
+// const getGoogleFilePicker = require('./getGoogleFilePicker');
+const createContact = require('./createContact');
+const createAppointment = require('./createAppointment');
+const updateAppointment = require('./updateAppointment');
+const confirmAppointment = require('./confirmAppointment');
+const cancelAppointment = require('./cancelAppointment');
+const listAppointments = 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/mcp/tools/listAppointments.js

@@ -0,0 +1,163 @@
+const jwt = require('../../lib/jwt');
+const connectorRegistry = require('../../connector/registry');
+const appointmentCore = 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.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            filter: {
+                type: 'string',
+                enum: ['upcoming', 'today', 'past', 'all', 'custom'],
+                description: [
+                    'Named time filter:',
+                    '  • "upcoming" — from today onward (next 3 months)',
+                    '  • "today"    — only today\'s appointments',
+                    '  • "past"     — everything before today (last 3 months)',
+                    '  • "all"      — last 3 months through next 3 months',
+                    '  • "custom"   — use startDate + endDate you provide',
+                ].join('\n')
+            },
+            startDate: {
+                type: 'string',
+                description: 'Start of custom date range in YYYY-MM-DD format. Only used when filter is "custom".'
+            },
+            endDate: {
+                type: 'string',
+                description: 'End of custom date range in YYYY-MM-DD format. Only used when filter is "custom".'
+            },
+            mineOnly: {
+                type: 'boolean',
+                description: 'When true, returns only appointments assigned to the current user. Defaults to false.'
+            }
+        },
+        required: []
+    },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+        destructiveHint: false
+    }
+};
+
+/**
+ * Build a YYYY-MM-DD string offset by `days` from today.
+ */
+function offsetDate(days) {
+    const d = new Date();
+    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.
+ */
+function resolveRange({ filter, startDate, endDate }) {
+    const f = (filter ?? 'all').toLowerCase();
+    switch (f) {
+        case 'upcoming':
+            return { startDate: todayStr(), endDate: offsetDate(90) };
+        case 'today':
+            return { startDate: todayStr(), endDate: todayStr() };
+        case 'past':
+            return { startDate: offsetDate(-90), endDate: offsetDate(-1) };
+        case 'custom':
+            return {
+                startDate: startDate ?? offsetDate(-90),
+                endDate: endDate ?? offsetDate(90)
+            };
+        case 'all':
+        default:
+            return { startDate: offsetDate(-90), endDate: offsetDate(90) };
+    }
+}
+
+/**
+ * Execute the listAppointments tool
+ * @param {Object} args
+ * @param {string} args.jwtToken - Injected server-side JWT token
+ * @param {string} [args.filter] - Named filter: upcoming | today | past | all | custom
+ * @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
+ */
+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,
+            range,
+            mineOnly: mineOnly ?? false,
+            forceSync: false
+        });
+
+        if (successful) {
+            return {
+                success: true,
+                data: {
+                    filter: filter ?? 'all',
+                    range,
+                    totalCount: appointments?.length ?? 0,
+                    appointments: appointments ?? []
+                }
+            };
+        }
+        else {
+            return {
+                success: false,
+                error: returnMessage?.message || 'Failed to list appointments'
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message || 'Unknown error occurred',
+            errorDetails: error.stack
+        };
+    }
+}
+
+exports.definition = toolDefinition;
+exports.execute = execute;