Pega DX MCP Server

import { BaseTool } from '../../registry/base-tool.js'; import { getSessionCredentialsSchema } from '../../utils/tool-schema.js'; import { extractFieldsFromViews, extractValidationErrors, groupFieldsByRequired, formatValidationErrors, extractFieldMetadata, formatFieldMetadata } from '../../utils/field-extractor.js'; export class RefreshAssignmentActionTool extends BaseTool { /** * Get the category this tool belongs to */ static getCategory() { return 'assignments'; } /** * Get tool definition for MCP protocol */ static getDefinition() { return { name: 'refresh_assignment_action', description: 'Refresh assignment action form data with updated values after property changes, execute Data Transforms, and handle table row operations in modals. Supports form refresh settings configured in Flow Action rules, generative AI form filling, and embedded list operations with comprehensive validation and preprocessing execution. The API validates assignment and action IDs, retrieves view data, and returns information about fields affected by the refresh action. Supports Pega Infinity \'25 features including table row operations in modals. OPTIONAL tool for progressive filling (multiple calls OK). Use refresh for partial updates with validation; use perform_assignment_action for final submission. Same eTag across refresh calls; NEW eTag after perform.', inputSchema: { type: 'object', properties: { assignmentID: { type: 'string', description: 'Assignment ID. Format: ASSIGN-WORKLIST {caseID}!{processID}. Example: "ASSIGN-WORKLIST MYORG-APP-WORK C-1001!PROCESS"' }, actionID: { type: 'string', description: 'Action ID from assignment (Example: "pyApproval", "Submit"). CRITICAL: Action IDs are CASE-SENSITIVE and have no spaces even if display names do ("Complete Review" → "CompleteReview"). Use get_assignment to find correct ID from actions array - use "ID" field not "name" field.' }, refreshFor: { type: 'string', description: 'Property name that triggers refresh when changed. Executes Data Transform from form refresh settings.' }, fillFormWithAI: { type: 'boolean', description: 'Whether to fill form with AI-generated sample values. Requires EnableGenerativeAI toggle. Default: false' }, operation: { type: 'string', enum: ['showRow', 'submitRow'], description: 'String value indicating table row operation type for embedded list properties using modals (Pega Infinity \'25+ feature). "showRow" is used when a row is being added or edited in a modal, triggering preprocessing of the interestPageActionID Action. "submitRow" is used when a row is being submitted, triggering validation and post-processing of the interestPageActionID Action. Only supported for table row operations in modals.' }, interestPage: { type: 'string', description: 'Target page specification for table row operations on embedded list properties. Example: ".OrderItems(1)" to target the first item in the OrderItems page list. This parameter is required when operation parameter is specified. Used with interestPageActionID to identify the specific embedded page and action for modal-based table operations.' }, interestPageActionID: { type: 'string', description: 'Action ID for the embedded list operation Action rule. Example: "EmbeddedAction". This specifies the Flow Action rule that defines the preprocessing, validation, and post-processing logic for the table row operation. Required when operation parameter is specified. Only fields present in this Action\'s view can be modified during pre/post-processing.' }, content: { type: 'object', description: 'Map of scalar properties and embedded page properties to be merged into the case during the refresh operation. Field values provided here will overwrite any settings made from preprocessing Data Transforms. Only fields that are present in the assignment action\'s view and are editable can be effectively updated. Non-visible fields cannot be set and updates to them may be lost in subsequent operations.' }, pageInstructions: { type: 'array', items: { type: 'object', properties: { instruction: { type: 'string', enum: ['UPDATE', 'REPLACE', 'DELETE', 'APPEND', 'INSERT', 'MOVE'], description: 'Page instruction type. UPDATE (add fields to page), REPLACE (replace entire page), DELETE (remove page), APPEND (add item to page list), INSERT (insert item in page list), MOVE (reorder page list items)' }, target: { type: 'string', description: 'Target embedded page name' }, content: { type: 'object', description: 'Content to set on the embedded page (required for UPDATE and REPLACE)' } }, required: ['instruction', 'target'], description: 'Page operation for embedded pages. Use REPLACE instruction to set embedded page references with full object including pzInsKey. Example: {"instruction": "REPLACE", "target": "PageName", "content": {"Property": "value", "pyID": "ID-123", "pzInsKey": "CLASS-NAME ID-123"}}' }, description: 'Optional list of page-related operations for embedded pages, page lists, or page groups. Required for setting embedded page references. Only pages included in the assignment action\'s view can be modified.' }, sessionCredentials: getSessionCredentialsSchema() }, required: ['assignmentID', 'actionID'] } }; } /** * Execute the refresh assignment action operation */ async execute(params) { const { assignmentID, actionID, refreshFor, fillFormWithAI = false, operation, interestPage, interestPageActionID, content, pageInstructions } = params; let sessionInfo = null; try { // Initialize session configuration if provided sessionInfo = this.initializeSessionConfig(params); // Basic parameter validation using base class const requiredValidation = this.validateRequiredParams(params, ['assignmentID', 'actionID']); if (requiredValidation) { return requiredValidation; } // Validate enum parameters using base class const enumValidation = this.validateEnumParams(params, { operation: ['showRow', 'submitRow'] }); if (enumValidation) { return enumValidation; } // Additional custom validation for complex business rules if (refreshFor !== undefined && (typeof refreshFor !== 'string' || refreshFor.trim() === '')) { return { error: 'Invalid refreshFor parameter. When provided, it must be a non-empty string representing the property name that triggers the refresh.' }; } if (fillFormWithAI !== undefined && typeof fillFormWithAI !== 'boolean') { return { error: 'Invalid fillFormWithAI parameter. a boolean value (true or false).' }; } // Conditional parameter validation for table row operations if (operation) { if (!interestPage || typeof interestPage !== 'string' || interestPage.trim() === '') { return { error: 'Invalid interestPage parameter. When operation is specified, interestPage is required and must be a non-empty string. Example: ".OrderItems(1)"' }; } if (!interestPageActionID || typeof interestPageActionID !== 'string' || interestPageActionID.trim() === '') { return { error: 'Invalid interestPageActionID parameter. When operation is specified, interestPageActionID is required and must be a non-empty string representing the embedded Action rule ID.' }; } } // Validate table row operations are only for modals (business rule validation) if (operation && !interestPage) { return { error: 'Table row operations are only supported for embedded list properties using modals. Ensure interestPage targets an embedded list property configured for modal operations.' }; } // Validate content parameter if (content !== undefined && (typeof content !== 'object' || Array.isArray(content))) { return { error: 'Invalid content parameter. an object containing property name-value pairs.' }; } // Validate pageInstructions parameter if (pageInstructions !== undefined && !Array.isArray(pageInstructions)) { return { error: 'Invalid pageInstructions parameter. an array of page instruction objects.' }; } // Auto-fetch eTag if not provided (required for refresh operations) let finalETag = undefined; // refresh_assignment_action doesn't accept eTag parameter yet let autoFetchedETag = false; try { console.log(`Auto-fetching latest eTag for assignment refresh on ${assignmentID}...`); const assignmentResponse = await this.pegaClient.getAssignment(assignmentID.trim(), { viewType: 'form' // Use form view for eTag retrieval }); if (!assignmentResponse || !assignmentResponse.success) { const errorMsg = `Failed to auto-fetch eTag: ${assignmentResponse?.error?.message || 'Unknown error'}`; return { error: errorMsg }; } finalETag = assignmentResponse.eTag; autoFetchedETag = true; console.log(`Successfully auto-fetched eTag: ${finalETag}`); if (!finalETag) { const errorMsg = 'Auto-fetch succeeded but no eTag was returned from get_assignment. This may indicate a server issue.'; return { error: errorMsg }; } } catch (error) { const errorMsg = `Failed to auto-fetch eTag: ${error.message}`; return { error: errorMsg }; } // Validate eTag format (should be a timestamp-like string) if (typeof finalETag !== 'string' || finalETag.trim().length === 0) { return { error: 'Invalid eTag parameter. a non-empty string representing case save date time.' }; } try { // Call Pega API to refresh assignment action const result = await this.pegaClient.refreshAssignmentAction( assignmentID.trim(), actionID.trim(), { refreshFor: refreshFor?.trim(), fillFormWithAI, operation, interestPage: interestPage?.trim(), interestPageActionID: interestPageActionID?.trim(), content, pageInstructions, eTag: finalETag } ); if (result.success) { return { content: [ { type: 'text', text: this.formatSuccessResponse(assignmentID, actionID, result.data, result.eTag, { refreshFor, fillFormWithAI, operation, interestPage, interestPageActionID, content, pageInstructions, autoFetchedETag }) } ] }; } else { return { content: [ { type: 'text', text: this.formatErrorResponse(assignmentID, actionID, result.error, { refreshFor, fillFormWithAI, operation, interestPage, interestPageActionID }) } ] }; } } catch (error) { return { error: `Unexpected error while refreshing assignment action ${actionID} for assignment ${assignmentID}: ${error.message}` }; } } catch (error) { return { content: [{ type: 'text', text: `## Error: Refresh Assignment Action\n\n**Unexpected Error**: ${error.message}\n\n${sessionInfo ? `**Session**: ${sessionInfo.sessionId} (${sessionInfo.authMode} mode)\n` : ''}*Error occurred at: ${new Date().toISOString()}*` }] }; } } /** * Format successful response for display */ formatSuccessResponse(assignmentID, actionID, data, eTag, options) { const { refreshFor, fillFormWithAI, operation, interestPage, interestPageActionID, content, pageInstructions, autoFetchedETag } = options; let response = `## Assignment Action Refresh Results: ${actionID}\n\n`; response += `**Assignment ID**: ${assignmentID}\n`; response += `**Action ID**: ${actionID}\n`; response += `**Refresh Operation**: ${operation || 'Basic form refresh'}\n\n`; // Display refresh operation details response += '### Refresh Operation Details\n'; if (refreshFor) { response += `- **Property Refreshed**: ${refreshFor}\n`; response += '- **Data Transform Executed**: Form refresh settings Data Transform\n'; } if (fillFormWithAI) { response += '- **Generative AI**: Form filled with AI-generated sample values\n'; } if (operation) { response += `- **Table Row Operation**: ${operation}\n`; response += `- **Target Page**: ${interestPage}\n`; response += `- **Embedded Action**: ${interestPageActionID}\n`; } response += '- **pyRefreshData Transform**: Executed after specific transforms\n'; response += '- **Field Conditions**: Required, Disabled, and Visibility conditions evaluated\n'; if (data.data) { // Display case information if available if (data.data.caseInfo) { const caseInfo = data.data.caseInfo; response += '\n### Associated Case Information\n'; response += `- **Case ID**: ${caseInfo.ID || caseInfo.businessID || 'N/A'}\n`; response += `- **Case Type**: ${caseInfo.caseTypeName || caseInfo.caseTypeID || 'N/A'}\n`; response += `- **Case Status**: ${caseInfo.status || 'N/A'}\n`; response += `- **Stage**: ${caseInfo.stageLabel || caseInfo.stageID || 'N/A'}\n`; response += `- **Urgency**: ${caseInfo.urgency || 'N/A'}\n`; response += `- **Owner**: ${caseInfo.owner || caseInfo.createdBy || 'N/A'}\n`; response += `- **Last Updated**: ${caseInfo.lastUpdateTime || 'N/A'}\n`; // Display assignment context within case if (caseInfo.assignments && caseInfo.assignments.length > 0) { response += '\n### Current Assignments\n'; caseInfo.assignments.forEach((assignment, index) => { response += `${index + 1}. **${assignment.name || assignment.ID}**\n`; response += ` - Assignment ID: ${assignment.ID}\n`; response += ` - Process: ${assignment.processName || assignment.processID || 'N/A'}\n`; response += ` - Assigned To: ${assignment.assigneeInfo?.name || assignment.assigneeInfo?.ID || 'N/A'}\n`; response += ` - Instructions: ${assignment.instructions || 'N/A'}\n`; response += ` - Urgency: ${assignment.urgency || 'N/A'}\n`; // Show actions for this assignment if (assignment.actions && assignment.actions.length > 0) { response += ` - Available Actions: ${assignment.actions.map(action => action.name || action.ID).join(', ')}\n`; } }); } // Display case content changes if available if (caseInfo.content && Object.keys(caseInfo.content).length > 0) { response += '\n### Updated Case Content\n'; for (const [key, value] of Object.entries(caseInfo.content)) { if (key !== 'classID' && key !== 'summary_of_associated_lists__') { response += `- **${key}**: ${value}\n`; } } } } // Display refresh-specific results if (data.data.refreshResults) { response += '\n### Form Refresh Results\n'; const refreshResults = data.data.refreshResults; if (refreshResults.updatedFields && refreshResults.updatedFields.length > 0) { response += '**Fields Updated by Refresh:**\n'; refreshResults.updatedFields.forEach((field, index) => { response += `${index + 1}. **${field.name}**: ${field.oldValue || 'N/A'} → ${field.newValue || 'N/A'}\n`; if (field.source) { response += ` - Updated by: ${field.source}\n`; } }); } if (refreshResults.validationResults) { response += '\n**Field Validation Results:**\n'; const validation = refreshResults.validationResults; if (validation.required) { response += `- Required fields: ${validation.required.join(', ')}\n`; } if (validation.disabled) { response += `- Disabled fields: ${validation.disabled.join(', ')}\n`; } if (validation.visible) { response += `- Visible fields: ${validation.visible.join(', ')}\n`; } } if (refreshResults.aiResults && fillFormWithAI) { response += '\n**Generative AI Results:**\n'; response += `- AI Form Filling: ${refreshResults.aiResults.success ? 'Successful' : 'Failed'}\n`; if (refreshResults.aiResults.fieldsGenerated) { response += `- Fields Generated: ${refreshResults.aiResults.fieldsGenerated.join(', ')}\n`; } if (refreshResults.aiResults.message) { response += `- AI Message: ${refreshResults.aiResults.message}\n`; } } } // Display table row operation results if (operation && data.data.tableRowResults) { response += '\n### Table Row Operation Results\n'; const rowResults = data.data.tableRowResults; response += `- **Operation**: ${operation}\n`; response += `- **Target Page**: ${interestPage}\n`; response += `- **Embedded Action**: ${interestPageActionID}\n`; if (operation === 'showRow') { response += '- **Preprocessing**: Executed for embedded action\n'; response += '- **Row Validation**: Completed\n'; } else if (operation === 'submitRow') { response += '- **Row Validation**: Completed\n'; response += '- **Post-processing**: Executed for embedded action\n'; } if (rowResults.validationErrors && rowResults.validationErrors.length > 0) { response += '\n**Row Validation Errors:**\n'; rowResults.validationErrors.forEach((error, index) => { response += `${index + 1}. ${error.field}: ${error.message}\n`; }); } if (rowResults.updatedFields && rowResults.updatedFields.length > 0) { response += '\n**Row Fields Updated:**\n'; rowResults.updatedFields.forEach((field, index) => { response += `${index + 1}. **${field.name}**: ${field.value}\n`; }); } } // Display content merge results if (content && Object.keys(content).length > 0) { response += '\n### Content Merge Results\n'; response += '- **User Content Applied**: Values merged into case\n'; response += '- **Override Priority**: User values take precedence over Data Transform values\n'; response += '- **Field Visibility**: Only editable and visible fields effectively updated\n'; } // Display page instruction results if (pageInstructions && pageInstructions.length > 0) { response += '\n### Page Instruction Results\n'; response += `- **Instructions Processed**: ${pageInstructions.length}\n`; response += '- **Page Operations**: Embedded pages, page lists, and page groups updated\n'; response += '- **Scope**: Only pages included in assignment action view modified\n'; } } // Display UI resources information if (data.uiResources) { response += '\n### UI Resources Updated\n'; response += '- **Form Metadata**: UI resources refreshed with updated field states\n'; if (data.uiResources.root) { response += `- **Root Component**: ${data.uiResources.root.type || 'Form'}\n`; if (data.uiResources.root.config?.name) { response += `- **View Name**: ${data.uiResources.root.config.name}\n`; } } if (data.uiResources.resources) { // Display updated fields if (data.uiResources.resources.fields) { const fieldCount = Object.keys(data.uiResources.resources.fields).length; response += `- **Form Fields Available**: ${fieldCount}\n`; const fieldNames = Object.keys(data.uiResources.resources.fields).slice(0, 10); if (fieldNames.length > 0) { response += `- **Key Fields**: ${fieldNames.join(', ')}\n`; if (Object.keys(data.uiResources.resources.fields).length > 10) { response += `- **(and ${Object.keys(data.uiResources.resources.fields).length - 10} more...)*\n`; } } } // Display available views after refresh if (data.uiResources.resources.views) { const viewCount = Object.keys(data.uiResources.resources.views).length; response += `- **Available Views**: ${viewCount}\n`; } } // Extract and display field metadata including dropdown options const fieldMetadata = extractFieldMetadata(data.uiResources); if (fieldMetadata.length > 0) { response += formatFieldMetadata(fieldMetadata); } // Display field state changes if (data.uiResources.fieldStates) { response += '\n**Field State Changes:**\n'; const states = data.uiResources.fieldStates; if (states.required && states.required.length > 0) { response += `- **Now Required**: ${states.required.join(', ')}\n`; } if (states.disabled && states.disabled.length > 0) { response += `- **Now Disabled**: ${states.disabled.join(', ')}\n`; } if (states.visible && states.visible.length > 0) { response += `- **Now Visible**: ${states.visible.join(', ')}\n`; } if (states.hidden && states.hidden.length > 0) { response += `- **Now Hidden**: ${states.hidden.join(', ')}\n`; } } } // Display execution sequence information response += '\n### Execution Sequence Completed\n'; response += '1. ✅ Case opened from database\n'; response += '2. ✅ Flow Action preprocessing executed (Data Transform + Activity)\n'; response += '3. ✅ Request body and page instructions merged into case\n'; if (refreshFor) { response += `4. ✅ Refresh Data Transform executed for property: ${refreshFor}\n`; response += '5. ✅ pyRefreshData Data Transform executed\n'; } else { response += '4. ✅ pyRefreshData Data Transform executed\n'; } if (operation === 'showRow') { response += `6. ✅ Embedded Action preprocessing executed: ${interestPageActionID}\n`; response += `7. ✅ Interest page row validated: ${interestPage}\n`; } else if (operation === 'submitRow') { response += `6. ✅ Interest page row validated: ${interestPage}\n`; response += `7. ✅ Embedded Action validation and post-processing: ${interestPageActionID}\n`; } response += '✅ Required, Disabled, and Visibility conditions evaluated\n'; // Display data limitations acknowledgment response += '\n### Data Limitations Acknowledged\n'; response += '- **Field Updates**: Only visible and editable fields in the view can be effectively updated\n'; response += '- **Non-visible Fields**: Cannot be set; updates may be lost in subsequent operations\n'; response += '- **Form Refresh**: Only change property events supported\n'; if (operation) { response += '- **Table Operations**: Pre/post-processing only supported for modal-based operations\n'; response += '- **Page Lists**: Cannot be added/updated/deleted from Data Transform\n'; } // Display eTag if available for future operations if (eTag) { response += '\n### Operation Support\n'; response += `- **eTag Captured**: ${eTag}\n`; if (autoFetchedETag) { response += '- **Auto-eTag Management**: ✅ Automatically retrieved latest eTag from assignment\n'; } response += '- **Ready for Assignment Action**: Use captured eTag for subsequent PATCH operations\n'; } response += '\n---\n'; response += `*Refresh completed at: ${new Date().toISOString()}*`; return response; } /** * Format error response for display */ formatErrorResponse(assignmentID, actionID, error, options) { const { refreshFor, fillFormWithAI, operation, interestPage, interestPageActionID } = options; let response = `## Error refreshing assignment action: ${actionID}\n\n`; response += `**Assignment ID**: ${assignmentID}\n`; response += `**Action ID**: ${actionID}\n`; response += `**Operation Type**: ${operation || 'Basic form refresh'}\n`; response += `**Error Type**: ${error.type}\n`; response += `**Message**: ${error.message}\n`; if (error.details) { response += `**Details**: ${error.details}\n`; } if (error.status) { response += `**HTTP Status**: ${error.status} ${error.statusText}\n`; } // Display operation context for error diagnosis if (refreshFor || fillFormWithAI || operation) { response += '\n### Operation Context\n'; if (refreshFor) { response += `- **Refresh Property**: ${refreshFor}\n`; } if (fillFormWithAI) { response += '- **AI Form Filling**: Enabled\n'; } if (operation) { response += `- **Table Operation**: ${operation}\n`; response += `- **Interest Page**: ${interestPage}\n`; response += `- **Embedded Action**: ${interestPageActionID}\n`; } } // Add specific guidance based on error type switch (error.type) { case 'NOT_FOUND': response += '\n**Suggestion**: Verify both the assignment ID and action ID are correct. The assignment might not exist, might have been completed, or the specific action might not be available for this assignment. For table row operations, ensure the interestPageActionID corresponds to a valid embedded Action rule.\n'; break; case 'FORBIDDEN': response += '\n**Suggestion**: Check if you have the necessary permissions to refresh this assignment action. The assignment might be restricted to specific users or roles, or form refresh settings might not be configured for this Flow Action rule. For generative AI operations, verify the EnableGenerativeAI toggle is enabled.\n'; break; case 'UNAUTHORIZED': response += '\n**Suggestion**: Authentication may have expired. The system will attempt to refresh the token on the next request.\n'; break; case 'BAD_REQUEST': response += '\n**Suggestion**: Check the assignment ID format and action ID. Assignment IDs should follow the pattern: ASSIGN-WORKLIST MYORG-SERVICES-WORK S-293001!APPROVAL_FLOW. Verify form refresh settings are properly configured in the Flow Action rule. For table operations, ensure interestPage format is correct (Example: ".OrderItems(1)").\n'; break; case 'VALIDATION_FAIL': response += '\n**Suggestion**: The submitted data failed validation rules. This could be due to:\n'; response += '- Required fields missing from the content\n'; response += '- Field values violating business rules or data validation\n'; response += '- Table row validation failures for embedded list operations\n'; response += '- Data Transform execution errors during preprocessing\n'; response += 'Review the field requirements and business rules for this assignment action.\n'; break; case 'LOCKED': response += '\n**Suggestion**: This assignment is currently locked by another user. Wait for the lock to be released or contact the user who has the lock. With pessimistic locking, only one user can access the assignment at a time.\n'; break; case 'CONFLICT': response += '\n**Suggestion**: The assignment state has changed since your last request. This could be due to:\n'; response += '- Another user performing actions on the same assignment\n'; response += '- Assignment state changes during form refresh processing\n'; response += '- Concurrent table row operations on embedded lists\n'; response += 'Refresh the assignment details and try again.\n'; break; case 'PRECONDITION_FAILED': response += '\n**Suggestion**: The eTag value provided does not match the current assignment state. Retrieve the latest assignment action details to get the current eTag value before attempting the refresh operation.\n'; break; case 'CONNECTION_ERROR': response += '\n**Suggestion**: Verify the Pega instance URL and network connectivity.\n'; break; case 'INTERNAL_SERVER_ERROR': response += '\n**Suggestion**: The Pega Infinity server encountered an internal error during refresh processing. This could be due to:\n'; response += '- Data Transform execution failures in form refresh settings\n'; response += '- Preprocessing or post-processing errors for embedded actions\n'; response += '- Generative AI service failures when fillFormWithAI=true\n'; response += '- Table row operation processing errors\n'; response += 'Check the Flow Action rule configuration and try again. Contact support if the issue persists.\n'; break; case 'FAILED_DEPENDENCY': response += '\n**Suggestion**: A required dependency failed during refresh processing. This could be due to:\n'; response += '- Missing or invalid form refresh settings in the Flow Action rule\n'; response += '- Embedded Action rule not found for table row operations\n'; response += '- Required Data Transform rules missing or having execution errors\n'; response += '- EnableGenerativeAI toggle not properly configured for AI operations\n'; response += 'Verify all dependencies and configuration settings are correct.\n'; break; } // Add data limitation context for errors if (error.type === 'VALIDATION_FAIL' || error.type === 'BAD_REQUEST') { response += '\n### Data Limitations Context\n'; response += '- Only fields present in the assignment action view and marked as editable can be updated\n'; response += '- Non-visible fields cannot be set and updates may be lost\n'; response += '- Form refresh settings only support change property events in Constellation\n'; if (operation) { response += '- Table row operations are only supported for embedded lists using modals\n'; response += '- Page List properties cannot be added/updated/deleted from Data Transform\n'; response += '- Pre/post-processing for embedded lists requires modal-based operations\n'; } if (fillFormWithAI) { response += '- Generative AI form filling requires both EnableGenerativeAI toggle and fillFormWithAI=true\n'; } } if (error.errorDetails && error.errorDetails.length > 0) { response += '\n### Additional Error Details\n'; error.errorDetails.forEach((detail, index) => { response += `${index + 1}. ${detail.localizedValue || detail.message}\n`; }); } response += '\n---\n'; response += `*Error occurred at: ${new Date().toISOString()}*`; return response; } }