@formio/uag 1.3.0

package/lib/router.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UAGRouter = UAGRouter;
+const express_1 = require("express");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+// Helper function to create JSON RPC error responses
+const createJsonRpcErrorResponse = (code, message) => {
+    return JSON.stringify({
+        error: { code, message },
+        id: null,
+        jsonrpc: "2.0",
+    });
+};
+/**
+ * Handle errors that occur during response processing.
+ * @param error The error that occurred.
+ * @param res The response object.
+ * @returns True if the error was handled, false otherwise.
+ */
+const handleResponseError = (error, res) => {
+    if (error instanceof Response) {
+        const fixedHeaders = {};
+        error.headers.forEach((value, key) => {
+            fixedHeaders[key] = value;
+        });
+        res.status(error.status).set(fixedHeaders).send(error.statusText);
+        return true;
+    }
+    console.error("[formio-uag] error handling request", error);
+    res.status(500).json(JSON.parse(createJsonRpcErrorResponse(-32603, "Internal Server Error")));
+    return false;
+};
+function UAGRouter(project) {
+    const router = (0, express_1.Router)();
+    // Handles the MCP post requests.
+    router.post('/', async (req, res) => {
+        try {
+            const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined, // Use "undefined" to trigger stateless mode.
+            });
+            project.mcpServer.connect(transport);
+            if (!transport) {
+                res.status(500).json(JSON.parse(createJsonRpcErrorResponse(-32603, "Unable to create MCP transport.")));
+                return;
+            }
+            (0, types_js_1.isInitializeRequest)(req.body);
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            handleResponseError(error, res);
+        }
+    });
+    // Handles the MCP get requests (for health checks, etc).
+    router.get('/', async (req, res) => {
+        try {
+            const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined, // Use "undefined" to trigger stateless mode.
+            });
+            project.mcpServer.connect(transport);
+            if (!transport) {
+                res.status(500).json(JSON.parse(createJsonRpcErrorResponse(-32603, "Unable to create MCP transport.")));
+                return;
+            }
+            await transport.handleRequest(req, res);
+        }
+        catch (err) {
+            handleResponseError(err, res);
+        }
+    });
+    // Return the router
+    return router;
+}
+;

package/lib/template.d.ts

@@ -0,0 +1,54 @@
+import { TemplateExecutor } from 'lodash';
+import { UAGTemplateConfig } from './config';
+/**
+ * Template names enum for type safety
+ */
+export declare enum ResponseTemplate {
+    collectedData = "collectedData",
+    submittedData = "submittedData",
+    fieldRules = "fieldRules",
+    allFieldsCollected = "allFieldsCollected",
+    getFormFieldsEmpty = "getFormFieldsEmpty",
+    getFormFieldsInfo = "getFormFieldsInfo",
+    fieldCollectedNext = "fieldCollectedNext",
+    submitValidationError = "submitValidationError",
+    formSubmitted = "formSubmitted",
+    listAvailableForms = "listAvailableForms",
+    confirmFormSubmission = "confirmFormSubmission",
+    getOptionalFields = "getOptionalFields",
+    formNotFound = "formNotFound",
+    noSubmissionsFound = "noSubmissionsFound",
+    submissionsFound = "submissionsFound",
+    submissionSearchError = "submissionSearchError",
+    submissionNotFound = "submissionNotFound",
+    updateNotConfirmed = "updateNotConfirmed",
+    submissionUpdateError = "submissionUpdateError",
+    submissionUpdated = "submissionUpdated",
+    submissionPartialIdAmbiguous = "submissionPartialIdAmbiguous",
+    submissionPartialIdNotFound = "submissionPartialIdNotFound",
+    getFormFields = "getFormFields",
+    getFormFieldsError = "getFormFieldsError",
+    fieldValidationErrors = "fieldValidationErrors",
+    fields = "fields",
+    fieldList = "fieldList",
+    getAvailableForms = "getAvailableForms",
+    noFormsAvailable = "noFormsAvailable"
+}
+export declare class UAGTemplate {
+    config: UAGTemplateConfig;
+    templateCache: Map<string, TemplateExecutor>;
+    constructor(config?: UAGTemplateConfig);
+    /**
+     * Get a template by name
+     * @param templateName The name of the template
+     * @returns The compiled template function
+     */
+    getTemplate(templateName: ResponseTemplate): TemplateExecutor;
+    /**
+     * Render a template with data
+     * @param templateName The name of the template
+     * @param data The data to render the template with
+     * @returns The rendered template
+     */
+    renderTemplate(templateName: ResponseTemplate, data?: object): string;
+}

package/lib/template.js

@@ -0,0 +1,120 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UAGTemplate = exports.ResponseTemplate = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const lodash_1 = require("lodash");
+/**
+ * Template names enum for type safety
+ */
+var ResponseTemplate;
+(function (ResponseTemplate) {
+    ResponseTemplate["collectedData"] = "collectedData";
+    ResponseTemplate["submittedData"] = "submittedData";
+    ResponseTemplate["fieldRules"] = "fieldRules";
+    ResponseTemplate["allFieldsCollected"] = "allFieldsCollected";
+    ResponseTemplate["getFormFieldsEmpty"] = "getFormFieldsEmpty";
+    ResponseTemplate["getFormFieldsInfo"] = "getFormFieldsInfo";
+    ResponseTemplate["fieldCollectedNext"] = "fieldCollectedNext";
+    ResponseTemplate["submitValidationError"] = "submitValidationError";
+    ResponseTemplate["formSubmitted"] = "formSubmitted";
+    ResponseTemplate["listAvailableForms"] = "listAvailableForms";
+    ResponseTemplate["confirmFormSubmission"] = "confirmFormSubmission";
+    ResponseTemplate["getOptionalFields"] = "getOptionalFields";
+    ResponseTemplate["formNotFound"] = "formNotFound";
+    ResponseTemplate["noSubmissionsFound"] = "noSubmissionsFound";
+    ResponseTemplate["submissionsFound"] = "submissionsFound";
+    ResponseTemplate["submissionSearchError"] = "submissionSearchError";
+    ResponseTemplate["submissionNotFound"] = "submissionNotFound";
+    ResponseTemplate["updateNotConfirmed"] = "updateNotConfirmed";
+    ResponseTemplate["submissionUpdateError"] = "submissionUpdateError";
+    ResponseTemplate["submissionUpdated"] = "submissionUpdated";
+    ResponseTemplate["submissionPartialIdAmbiguous"] = "submissionPartialIdAmbiguous";
+    ResponseTemplate["submissionPartialIdNotFound"] = "submissionPartialIdNotFound";
+    ResponseTemplate["getFormFields"] = "getFormFields";
+    ResponseTemplate["getFormFieldsError"] = "getFormFieldsError";
+    ResponseTemplate["fieldValidationErrors"] = "fieldValidationErrors";
+    ResponseTemplate["fields"] = "fields";
+    ResponseTemplate["fieldList"] = "fieldList";
+    ResponseTemplate["getAvailableForms"] = "getAvailableForms";
+    ResponseTemplate["noFormsAvailable"] = "noFormsAvailable";
+})(ResponseTemplate || (exports.ResponseTemplate = ResponseTemplate = {}));
+class UAGTemplate {
+    constructor(config = {}) {
+        this.config = config;
+        this.templateCache = new Map();
+    }
+    /**
+     * Get a template by name
+     * @param templateName The name of the template
+     * @returns The compiled template function
+     */
+    getTemplate(templateName) {
+        if (this.templateCache.has(templateName)) {
+            return this.templateCache.get(templateName);
+        }
+        let templateContent = '';
+        if (this.config[templateName]) {
+            templateContent = this.config[templateName];
+        }
+        else {
+            const templatePath = path.join(path.join(__dirname, 'templates') || '', `${templateName}.md`);
+            if (!fs.existsSync(templatePath))
+                throw new Error(`Template '${templateName}' not found at ${templatePath}`);
+            templateContent = this.config[templateName] || fs.readFileSync(templatePath, 'utf-8');
+        }
+        const compiled = (0, lodash_1.template)(templateContent);
+        this.templateCache.set(templateName, compiled);
+        return compiled;
+    }
+    /**
+     * Render a template with data
+     * @param templateName The name of the template
+     * @param data The data to render the template with
+     * @returns The rendered template
+     */
+    renderTemplate(templateName, data = {}) {
+        try {
+            const template = this.getTemplate(templateName);
+            return template(data);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to render template '${templateName}': ${errorMessage}`);
+        }
+    }
+}
+exports.UAGTemplate = UAGTemplate;

package/lib/templates/allFieldsCollected.md

@@ -0,0 +1,17 @@
+**All required fields have been collected for <%= parentLabel %>!**
+<% if (parentDataPath) { %>
+This data was collected within the data path of **<%= parentDataPath %>**.
+<% } %>
+<%= dataSummary %>
+
+**Next Steps**:
+<% if (parent && parent.isTable) { %>
+1. Use the `get_form_fields` tool with the same `parent` parameter and `criteria` set to "optional" to check if there are optional fields. If so, ask the user if they wish to fill any of them out for this row.
+2. If there are no optional fields, or the user declines, then ask the user if they wish to "Add Another" (add another row to the table). If they affirm, then use the `collect_field_data` tool to collect the next row's data. Make sure to increment the row index for the fields within this parent component (e.g. <%= parent.data_path %>[<%= rowIndex %>] => <%= parent.data_path %>[<%= (rowIndex + 1) %>]) when collecting data for the next row.
+3. If they do not wish to "Add Another", then use the `get_form_fields` tool to determine if there are any more fields that need to be collected outside of the <%= parent.label %> component. If so, use the `collect_field_data` tool to collect that information (make sure to change the `parent` parameter to the level above the <%= parent.label %> field, or to `null` if we are at the root of the form).
+<% } else if (parent && (parent.isForm || parent.isContainer)) { %>
+1. Use the `get_form_fields` tool with the same `parent` parameter and `criteria` set to "optional" to check if there are optional fields. If so, ask the user if they wish to fill any of them out.
+2. If there are no optional fields, or the user declines, then use the `get_form_fields` tool to determine if there are any more fields that need to be collected outside of the <%= parent.label %> component. If so, use the `collect_field_data` tool to collect that information (make sure to change the parent parameter to the level above the <%= parent.label %> field, or to `null` if we are at the root of the form).
+<% } else { %>
+1. Use the `get_form_fields` tool with the `criteria` set to "optional" to check if there are optional fields. If so, ask the user if they wish to fill any of them out.
+2. If there are no optional fields, or the user declines, then use the `confirm_form_submission` tool to show summary and get confirmation to submit the form.<% } %>

package/lib/templates/collectedData.md

@@ -0,0 +1,5 @@
+## Collected Data
+IMPORTANT: When presenting the values to the user, it must appear exactly as it will be submitted; e.g "user@example.com", "(555) 123-4560"
+
+<% data.forEach(function(item) { %><%= item.prefix %>- **<%= item.label %>**: <%= item.value %>
+<% }); %>

package/lib/templates/confirmFormSubmission.md

@@ -0,0 +1,18 @@
+# Confirm Form Submission
+
+All the required information for your **<%= form.title %>** form has been collected.
+
+Please review the following data before submission:
+
+<%= dataSummary %>
+
+**Please confirm:** Does this information look correct? 
+
+- Say or type "yes" or "confirm" to submit this form
+- Say or type "no" or "cancel" to make changes
+- Tell me which field you'd like to modify if you need to make changes
+
+Only use `submit_completed_form` if the user explicitly confirms (says "yes", "confirm", "submit", etc.).
+
+**Current Data**:
+<%= JSON.stringify(currentData, null, 2) %>

package/lib/templates/fieldCollectedNext.md

@@ -0,0 +1,14 @@
+<%= message %>
+<% if (parent) { %>
+The following data is being collected for the nested component **<%= parent.label %> (<%= parent.type %>)**.  The parent `data_path` is **parent.data_path**, and all of the child data is collected within the path of **<%= parentDataPath %>**.
+<% } %>
+## Progress: <%= progress.collected %>/<%= progress.total %> required fields collected for <%= parentLabel %>.
+
+## Remaining required fields for <%= parentLabel %>:
+<%= fields %>
+Use the `collect_field_data` tool to provide values for the remaining required fields for <%= parentLabel %>. You can collect multiple fields at once by providing an array of field updates.
+
+<%= dataSummary %>
+
+**Next Steps**:
+1. Ask the user for any remaining required fields for <%= parentLabel %>.

package/lib/templates/fieldList.md

@@ -0,0 +1,5 @@
+<% fields.forEach(function(field) { %>
+- **<%= field.label %>**
+  - data_path: "<%= field.path %>"
+  - field_type: <%= field.type %><% if (field.description) { %>
+  - Description: <%= field.description %><% } %><% }); %>

package/lib/templates/fieldRules.md

@@ -0,0 +1,4 @@
+**Field Type Rules**
+The following rules should be used for the value of every field type (field_type) within this form.
+<% rules.forEach(function([type, rule]) { %>
+  - **<%= type %>**: <%= rule %><% }) %>

package/lib/templates/fieldValidationErrors.md

@@ -0,0 +1,7 @@
+## ❌ Field Validation Errors
+
+The following fields have validation errors that need to be corrected:
+<% invalidFields.forEach(function(field) { %>
+ - **<%= field.label %> (<%= field.path %>)**: <%= field.error %><% }); %>
+
+Please provide valid values for these fields and try again.

package/lib/templates/fields.md

@@ -0,0 +1,19 @@
+<% fields.forEach(function(field, index) { %>
+<%= index + 1 %>. **<%= field.label %>**
+  - **Data Path (data_path)**: "<%= field.path %>"
+  - **Label**: <%= field.label %>
+  - **Type**: <%= field.type %>
+  - **Required**: <% if (field.validation.required) { %>✅ Yes<% } else { %>❌ No<% } %>
+  - **Has Nested Components**:  <% if (field.nested) { %>✅ Yes<% } else { %>❌ No<% } %><% if (field.description) { %>
+  - **Description**: <%= field.description %><% } %><% if (field.prompt) { %>
+  - **Prompt**: <%= field.prompt %><% } %><% if (field.format) { %>
+  - **Format**: <%= field.format %><% } %><% if (field.options) { %>
+  - **Options**: <% field.options.forEach(function(option) { %>
+    - <%= option.label %> (<%= option.value %>)<% }) %><% } %><% if (field.validation && Object.keys(field.validation).length > 0) { %>
+  - **Validation**:<% if (field.validation.minLength) { %>
+    - Min Length: <%= field.validation.minLength %><% } %><% if (field.validation.maxLength) { %>
+    - Max Length: <%= field.validation.maxLength %><% } %><% if (field.validation.pattern) { %>
+    - Pattern: <%= field.validation.pattern %><% } %><% if (field.validation.min) { %>
+    - Min Value: <%= field.validation.min %><% } %><% if (field.validation.max) { %>
+    - Max Value: <%= field.validation.max %><% } %><% } %>
+<% }); %>

package/lib/templates/formNotFound.md

@@ -0,0 +1 @@
+❌ Form "<%= formName %>" is not found.

package/lib/templates/formSubmitted.md

@@ -0,0 +1,7 @@
+# Form Submitted Successfully! ✅
+
+**Form**: <%= form.title %><% if (submissionId) { %>
+**Submission ID** (for internal and future lookup use only): <%= submissionId %><% } %>
+**Submitted Fields**: <%= submittedFieldsCount %>
+
+<%= dataSummary %>

package/lib/templates/getAvailableForms.md

@@ -0,0 +1,18 @@
+Total forms (<%= totalForms %> total):
+
+<% _.forEach(forms, function(form) { %>
+- <%= form.title %> (**<%= form.name %>**):<% if (form.description) { %>
+  - **Description**: <%= form.description %><% } %><% if (!form.hasAccess) { %>
+  - **Permissions**: You do not have access to this form.<% } else { %>
+  - **Permissions**: <% if (form.permissions.create) { %>Create<% } %><% if (form.permissions.read) { %><% if (form.permissions.create) { %>, <% } %>Read<% } %><% if (form.permissions.update) { %><% if (form.permissions.create || form.permissions.read) { %>, <% } %>Update<% } %> submissions (records)
+<% } %><% }); %>
+
+If the user wishes to submit a form they do not have the "Create" permission, then let them know that they do not have the permission to submit that form.
+
+If the user wishes to search for a record and they do not have the "Read" permission, then let them know that they do not have the permission to search for records.
+
+If the user wishes to update an existing record and they do not have the "Update" permission, then let them know that they do not have permission to update records.
+
+If they are simply asking about what forms are available, then you can use this list to provide them simple explaination about the forms available without the need for any permissions.
+
+If the user has permission to perform the operation, and it is clear which form they wish to engage with, then immediately use the `get_form_fields`  tool to understand how the data is structured within this form.

package/lib/templates/getFormFields.md

@@ -0,0 +1,16 @@
+<%= message %>## <%= type %> fields for <%= parentLabel %>
+<% if (parent) { %>
+All values for these fields should be stored within the `data_path`="<%= parentDataPath %>" (e.g. "<%= parentDataPath %>.exampleField")
+<% } %>
+### Summary
+- Total fields for <%= parentLabel %>: <%= totalFields %>
+- Total fields collected for <%= parentLabel %>: <% totalCollected %>
+- Number of <%= type %> fields for <%= parentLabel %>: <%= totalType %>
+- Number of <%= type %> fields collected for <%= parentLabel %>: <%= totalTypeCollected %>
+
+<%= rules %>
+
+### <%= type %> fields for <%= parentLabel %>
+<%= fieldList %>
+
+Once the user provides provides some context, use the `get_field_info` tool to understand how to validate and process the data that was collected. Make sure to set the `field_paths` to only the paths of the fields that the user has provided values for.

package/lib/templates/getFormFieldsEmpty.md

@@ -0,0 +1,4 @@
+No fields were found matching your specified `criteria` for <%= parentLabel %>.
+<% if (parent) { %>
+Considering the search was made within a `parent` context, try the search again at a higher `parent` context.
+<% } %>

package/lib/templates/getFormFieldsError.md

@@ -0,0 +1,7 @@
+## Error: Unable to Get Form Fields
+
+❌ **Error occurred while extracting fields for form "<%= form.title %>"**
+
+**Error Details**: <%= error %>
+
+Please try again or contact support if the issue persists.

package/lib/templates/getFormFieldsInfo.md

@@ -0,0 +1,6 @@
+Here is the field information for the fields requested.
+
+### Field Information
+<%= fields %>
+
+Use the `collect_field_data` tool to collect field information that the user has provided.

package/lib/templates/getOptionalFields.md

@@ -0,0 +1,19 @@
+# Optional Fields Available
+
+All required fields have been collected for your **<%= form.title %>** form.
+
+**Would you like to fill out any optional fields?**
+
+There are <%= totalOptionalFields %> optional fields available:
+<%= optionalFields %>
+
+If values for any of these fields are already provided, then skip to the `collect_field_data` tool to add those additional fields. Otherwise, use the following options.
+
+**Options:**
+- Say "yes" or "I'd like to fill optional fields" to add optional information
+- Say "no" or "skip optional fields" to proceed with just the required information
+- Say the name of a specific field you'd like to fill (e.g., "email")
+
+Use the `collect_field_data` tool to collect any optional fields the user wants to fill.
+
+If they wish to skip the collection of optional fields, then use the `submit_completed_form` to submit the required data to the form.

package/lib/templates/noFormsAvailable.md

@@ -0,0 +1,3 @@
+<%= message %>
+
+There are currently no forms configured in this project. Please contact your administrator to set up forms.

package/lib/templates/noSubmissionsFound.md

@@ -0,0 +1,11 @@
+No submissions found for the <%= form.title %> form matching "<%= searchQuery %>".
+
+The search didn't return any results. This could mean:
+- No submissions exist with the specified criteria
+- The search terms might need to be more specific
+- The data might be stored in different fields than expected
+
+You can try:
+- Using different search terms
+- Being more specific with names or identifiers
+- Checking if the form name is correct

package/lib/templates/submissionNotFound.md

@@ -0,0 +1,6 @@
+Submission with ID "<%= submissionId %>" was not found for the <%= form.title %> form.
+
+Please check:
+- The submission ID is correct
+- The submission exists in this form
+- You have permission to access this submission

package/lib/templates/submissionPartialIdAmbiguous.md

@@ -0,0 +1,12 @@
+Multiple submissions found ending with "<%= partialId %>" - the partial ID is not unique enough.
+
+**Matching submissions:**
+<% matchingSubmissions.forEach(function(submission, index) { %>
+**Submission <%= index + 1 %>** (Full ID: <%= submission.fullId %>)
+<% submission.data.forEach(function(item) { %>
+- **<%= item.label %>:** <%= item.value %>
+<% }); %>
+---
+<% }); %>
+
+Please use a longer portion of the submission ID to uniquely identify which record you want to update.

package/lib/templates/submissionPartialIdNotFound.md

@@ -0,0 +1,12 @@
+No submission found ending with "<%= partialId %>" for search "<%= searchQuery %>" in <%= form.title %>.
+
+**Available submissions:**
+<% availableSubmissions.forEach(function(submission, index) { %>
+**Submission <%= index + 1 %>** (ID ends with: **<%= submission.partialId %>**)
+<% submission.data.forEach(function(item) { %>
+- **<%= item.label %>:** <%= item.value %>
+<% }); %>
+---
+<% }); %>
+
+Please try again with one of the partial IDs shown above, or be more specific in your search query.

package/lib/templates/submissionSearchError.md

@@ -0,0 +1,8 @@
+Error searching submissions for <%= form.title %>: <%= error %>
+
+The search for "<%= searchQuery %>" encountered an error. Please check:
+- The form name is correct
+- The search criteria is valid
+- The API connection is working
+
+Try rephrasing your search or contact support if the issue persists.

package/lib/templates/submissionUpdateError.md

@@ -0,0 +1,6 @@
+Error updating submission <%= submissionId %> for <%= form.title %>: <%= error %>
+
+The update could not be completed. Please check:
+- You have permission to modify this submission
+- The field values are valid
+- The API connection is working

package/lib/templates/submissionUpdated.md

@@ -0,0 +1,15 @@
+Successfully updated the record in <%= form.title %>!
+ - id: <%= submissionId %>
+ - created: <%= created %>
+ - modified: <%= modified %>
+
+**Updated Fields (<%= totalFieldsUpdated %> total):** (It is VERY important to show the values to the user exactly as they were submitted/posted)
+<% updateSummary.forEach(function(update) { %>
+- **<%= update.data_path %>:**
+  - Previous: "<%= update.previous_value %>"
+  - New: "<%= update.new_value %>"
+<% }); %>
+
+<%= dataSummary %>
+
+All <%= totalFieldsUpdated %> field(s) have been successfully updated.

package/lib/templates/submissionsFound.md

@@ -0,0 +1,25 @@
+Found <%= resultCount %> submissions for <%= form.title %> matching "<%= searchQuery %>":
+
+<% submissions.forEach(function(submission, index) { %>
+**Submission <%= index + 1 %>**
+- **ID:** <%= submission._id %>
+- **Requested Data:**
+<% submission.data.forEach(function(field) { %>
+    - <%= field.path %>: <%= field.value %>
+<% }); %>
+- **Partial ID (submission_id_partial):** <%= submission.partialId %>
+- **Created:** <%= submission.created %>
+- **Updated:** <%= submission.modified %>
+<% }); %>
+<% if (submissions.length > 1) { %>
+**Multiple submissions found. To proceed:**
+1. **Be more specific** in your search query to find just one record, OR
+2. **Provide the last 4 characters** of the submission ID you want to update (shown above as "ID ends with")
+
+Example: "Update the submission ending in **abc1**" or use `find_submissions` with `submission_id_partial: "abc1"`
+
+**Note:** All <%= fieldUpdates.length %> field update(s) will be applied to whichever submission you select.
+<% } else { %>
+
+Use the `confirm_submission_update` tool with the submission_id set to the full submission ID to submit the data.
+<% } %>

package/lib/templates/submitValidationError.md

@@ -0,0 +1,7 @@
+Cannot submit the form due to the following reasons:
+<% validationErrors.forEach(function(error) { %>
+ - <% if (error.label && error.path) { %>**<%= error.label %> (<%= error.path %>)**: <% } %><%= error.message %><% }); %>
+
+These validation errors are in one of the following format:
+ - **Field Label (data_path)** - Error message:  If the error is attributed to a specific field value.
+ - Error message:  If the error is a general error that is not specific to a field value.

package/lib/templates/submittedData.md

@@ -0,0 +1,4 @@
+**Submission Data Summary:** (IMPORTANT NOTE: When presenting the values to the user, it must appear exactly as they are in the submission; e.g "user@example.com", "(555) 123-4560")
+<% data.forEach(function(item) { %>
+- **<%= item.label %>**: <%= item.value %>
+<% }); %>