@formio/uag 1.10.0 → 1.10.2

package/lib/template.d.ts

@@ -18,6 +18,7 @@ export declare enum ResponseTemplate {
     formNotFound = "formNotFound",
     noSubmissionsFound = "noSubmissionsFound",
     submissionsFound = "submissionsFound",
+    submissionCount = "submissionCount",
     submissionSearchError = "submissionSearchError",
     submissionNotFound = "submissionNotFound",
     updateNotConfirmed = "updateNotConfirmed",

package/lib/template.js

@@ -56,6 +56,7 @@ var ResponseTemplate;
     ResponseTemplate["formNotFound"] = "formNotFound";
     ResponseTemplate["noSubmissionsFound"] = "noSubmissionsFound";
     ResponseTemplate["submissionsFound"] = "submissionsFound";
+    ResponseTemplate["submissionCount"] = "submissionCount";
     ResponseTemplate["submissionSearchError"] = "submissionSearchError";
     ResponseTemplate["submissionNotFound"] = "submissionNotFound";
     ResponseTemplate["updateNotConfirmed"] = "updateNotConfirmed";

package/lib/templates/submissionCount.md

@@ -0,0 +1 @@
+There are **<%= submissionCount %>** total submissions within the <%= form.title %> form.

package/lib/templates/submissionsFound.md

@@ -1,16 +1,13 @@
-Found <%= resultCount %> submissions for <%= form.title %> matching "<%= searchQuery %>":
-
+Found **<%= submissions.length %>** out of **<%= submissionCount %>** total submissions for <%= form.title %> matching the query "<%= searchQuery %>":
 <% submissions.forEach(function(submission, index) { %>
 **Submission <%= index + 1 %>**
-- **ID:** <%= submission._id %>
-- **Requested Data:**
+ - **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 %>
-<% }); %>
+<% }); %> - **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
@@ -18,8 +15,5 @@ Found <%= resultCount %> submissions for <%= form.title %> matching "<%= searchQ
 
 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/tools/SchemaBuilder.js

@@ -118,7 +118,7 @@ class SchemaBuilder {
                 'less_than_equal'
             ]).optional().default('contains').describe('The operator to use for matching. "equals" for exact match, "contains" for substring match, "starts_with" or "ends_with" for prefix/suffix match, "regex" for regular expression match, "greater_than" or "less_than" only for numeric values, "in" if searching for multiple values as comma-separated values, "nin" if excluding multiple values as comma-separated values.'),
             search_value: zod_1.default.string().describe('The value of the field to use when searching.')
-        }).describe('Object containing the `data_path` and search value. Use `get_form_fields` to get all the field information to populate this search query object.')).describe('Array of search criteria to find matching submissions. All criteria must match (AND logic).');
+        }).describe('Object containing the `data_path` and search value. Use `get_form_fields` to get all the field information to populate this search query object.')).optional().describe('Array of search criteria to find matching submissions. All criteria must match (AND logic). Do not provide this parameter to get the total count of submissions without retrieving the submission details.');
         return this;
     }
     /**

package/lib/tools/findSubmission.js

@@ -9,7 +9,7 @@ const findSubmission = async (project) => {
     return (0, lodash_1.defaultsDeep)(project.config?.toolOverrides?.find_submissions || {}, {
         name: 'find_submissions',
         title: 'Find submissions within a form',
-        description: 'Find existing form submissions based on field values (search query). Use this to search for people, records, or data by name, email, phone, position, company, or other field values. Examples: find a contact by name, find someone who works at a company, find records with specific criteria.',
+        description: 'Find existing form submissions based on field values (search query). Use this to search for people, records, or data by name, email, phone, position, company, or other field values. Examples: find a contact by name, find someone who works at a company, find records with specific criteria. To retrieve the total count of records within a form, use this tool without providing a `search_query`.',
         inputSchema: (new SchemaBuilder_1.SchemaBuilder(project))
             .form_name()
             .search_query()
@@ -22,8 +22,9 @@ const findSubmission = async (project) => {
             if (!form) {
                 return project.mcpResponse(template_1.ResponseTemplate.formNotFound, { formName: form_name }, true);
             }
+            search_query = search_query || [];
             const query = {};
-            if (!submission_id) {
+            if (!submission_id && search_query.length > 0) {
                 for (const criterion of search_query) {
                     if (!criterion.data_path || !criterion.search_value) {
                         return project.mcpResponse(template_1.ResponseTemplate.submissionSearchError, {
@@ -80,17 +81,29 @@ const findSubmission = async (project) => {
                 }
             }
             try {
+                let submissionCount = 0;
                 let submissions = [];
                 if (submission_id) {
                     const result = await form.loadSubmission(submission_id, extra.authInfo);
                     if (result) {
                         submissions = [result];
+                        submissionCount = 1;
                     }
                 }
                 else {
                     query.limit = ((0, lodash_1.isNumber)(limit) && limit > 0) ? limit : 10;
-                    const result = await form.find(query, extra.authInfo);
-                    submissions = result.items;
+                    if (search_query.length > 0) {
+                        const result = await form.find(query, extra.authInfo);
+                        submissions = result.items;
+                        submissionCount = result.count;
+                    }
+                    else {
+                        submissionCount = await form.count({}, extra.authInfo);
+                        return project.mcpResponse(template_1.ResponseTemplate.submissionCount, {
+                            form: form.form,
+                            submissionCount
+                        });
+                    }
                 }
                 if (!submissions || submissions.length === 0) {
                     return project.mcpResponse(template_1.ResponseTemplate.noSubmissionsFound, {
@@ -139,6 +152,7 @@ const findSubmission = async (project) => {
                 return project.mcpResponse(template_1.ResponseTemplate.submissionsFound, {
                     form: form.form,
                     searchQuery: JSON.stringify(search_query),
+                    submissionCount,
                     submissions: submissions.map(sub => {
                         return {
                             _id: sub._id,
@@ -147,8 +161,7 @@ const findSubmission = async (project) => {
                             data: getFieldValues(sub),
                             partialId: sub._id ? sub._id.toString().slice(-4) : 'N/A'
                         };
-                    }),
-                    resultCount: submissions.length
+                    })
                 });
             }
             catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formio/uag",
-  "version": "1.10.0",
+  "version": "1.10.2",
   "description": "The Form.io Universal Agent Gateway (UAG).",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -15,7 +15,7 @@
     "build:ts": "npx tsc",
     "build:copy-templates": "mkdir -p lib/templates && cp src/templates/*.md lib/templates/",
     "build": "npm run clean && npm run build:ts && npm run build:copy-templates",
-    "build:docker": "npm run build && docker build -t formio/uag --platform=linux/amd64 .",
+    "build:docker": "docker build -t formio/uag$(node -p \"require('./package.json').version.includes('-rc.') ? ':rc' : ''\") --platform=linux/amd64 .",
     "test": "TS_NODE_PROJECT=tsconfig.test.json mocha --no-node-snapshot",
     "dev": "tsx --no-node-snapshot index.js",
     "start": "node --no-node-snapshot index.js",
@@ -24,9 +24,9 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@formio/appserver": "^2.12.0",
+    "@formio/appserver": "^2.12.2",
     "@formio/core": "2.5.1-dev.291.6557e4e",
-    "@modelcontextprotocol/sdk": "1.27.0",
+    "@modelcontextprotocol/sdk": "1.27.1",
     "cors": "^2.8.6",
     "debug": "^4.4.3",
     "dotenv": "^17.3.1",
@@ -37,6 +37,12 @@
     "node-html-markdown": "^2.0.0",
     "zod": "^4.3.6"
   },
+  "resolutions": {
+    "tar": ">=7.5.7",
+    "minimatch": ">=10.2.1",
+    "brace-expansion": ">=5.0.1",
+    "diff": ">=8.0.3"
+  },
   "devDependencies": {
     "@types/chai": "^5.2.3",
     "@types/cors": "^2.8.19",
@@ -44,10 +50,10 @@
     "@types/dotenv": "^8.2.3",
     "@types/express": "^5.0.6",
     "@types/jsonwebtoken": "^9.0.10",
-    "@types/lodash": "^4.17.23",
+    "@types/lodash": "^4.17.24",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^25.3.0",
-    "@types/supertest": "^6.0.3",
+    "@types/node": "^25.3.2",
+    "@types/supertest": "^7.2.0",
     "chai": "^6.2.2",
     "mocha": "^11.7.5",
     "supertest": "^7.2.2",