@formio/uag 1.8.0 → 1.9.0-rc.1

package/lib/UAGProjectInterface.d.ts

@@ -16,6 +16,14 @@ export declare class UAGProjectInterface extends ProjectInterface {
     addForm(form: Form, key: string): UAGFormInterface | undefined;
     router(): Promise<any>;
     authorizeRequest(req: SubmissionRequest, res: Response, next: NextFunction): Promise<Response<any, Record<string, any>> | undefined>;
+    mcpJSONResponse(data?: object, isError?: boolean): {
+        isError?: boolean | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        structuredContent: object;
+    };
     mcpResponse(templateName: ResponseTemplate, data?: object, isError?: boolean): {
         isError?: boolean | undefined;
         content: {

package/lib/UAGProjectInterface.js

@@ -81,6 +81,18 @@ class UAGProjectInterface extends appserver_1.ProjectInterface {
             });
         }
     }
+    mcpJSONResponse(data = {}, isError = false) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(data),
+                }
+            ],
+            structuredContent: data,
+            ...(isError && { isError: true }),
+        };
+    }
     mcpResponse(templateName, data = {}, isError = false) {
         return {
             content: [

package/lib/tools/SchemaBuilder.d.ts

@@ -56,6 +56,7 @@ export declare class SchemaBuilder {
      *
      */
     criteria(): this;
+    as_json(): this;
     /**
      * An array of search criteria to find matching submissions.
      * All criteria must match (AND logic).

package/lib/tools/SchemaBuilder.js

@@ -76,6 +76,10 @@ class SchemaBuilder {
         this.schema.criteria = zod_1.default.enum(['all', 'required', 'optional']).default('required').describe('Returns only the fields of the specified criteria. "all" returns all fields, "required" returns only the required fields, and "optional" returns only optional fields. To start a new form collection flow, you typically want to get only the "required" fields first.');
         return this;
     }
+    as_json() {
+        this.schema.as_json = zod_1.default.boolean().optional().default(false).describe('If true, the submission data will be returned as a JSON object result instead of formatted text. Any errors will also be returned as a structured JSON array. Set this property to `true` ONLY if the prompt indicates that JSON output of the submission data is required.');
+        return this;
+    }
     /**
      * An array of search criteria to find matching submissions.
      * All criteria must match (AND logic).

package/lib/tools/collectData.js

@@ -13,8 +13,9 @@ const collectData = async (project) => {
             .form_name()
             .form_data()
             .parent_path()
+            .as_json()
             .updates().schema,
-        execute: async ({ form_name, form_data, parent_path, updates }, extra) => {
+        execute: async ({ form_name, form_data, parent_path, as_json, updates }, extra) => {
             const form = await project.getForm(form_name);
             if (!form) {
                 return project.mcpResponse(template_1.ResponseTemplate.formNotFound, { formName: form_name }, true);
@@ -30,8 +31,15 @@ const collectData = async (project) => {
             // Find next required field that hasn't been filled
             const fields = await form.getFields(submission, extra.authInfo, parent?.data_path);
             if (fields.errors.length > 0) {
+                if (as_json) {
+                    return project.mcpJSONResponse(fields.errors);
+                }
                 return project.mcpResponse(template_1.ResponseTemplate.fieldValidationErrors, { invalidFields: fields.errors });
             }
+            // If JSON output is requested, return the raw submission data.
+            if (as_json) {
+                return project.mcpJSONResponse(submission);
+            }
             // If no required fields remain, then we can move onto a new tool.
             if (!fields.required.components.length) {
                 return project.mcpResponse(template_1.ResponseTemplate.allFieldsCollected, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formio/uag",
-  "version": "1.8.0",
+  "version": "1.9.0-rc.1",
   "description": "The Form.io Universal Agent Gateway (UAG).",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -23,9 +23,9 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@formio/appserver": "^2.8.0",
+    "@formio/appserver": "^2.9.0",
     "@formio/core": "2.5.1-dev.291.6557e4e",
-    "@modelcontextprotocol/sdk": "^1.23.0",
+    "@modelcontextprotocol/sdk": "^1.25.2",
     "cors": "^2.8.5",
     "debug": "^4.4.1",
     "dotenv": "^17.2.1",
@@ -33,7 +33,7 @@
     "jsonwebtoken": "^9.0.2",
     "lodash": "^4.17.21",
     "node-cache": "^5.1.2",
-    "zod": "^4.1.13"
+    "zod": "^4.3.5"
   },
   "devDependencies": {
     "@types/chai": "^5.2.3",
@@ -44,11 +44,11 @@
     "@types/jsonwebtoken": "^9.0.10",
     "@types/lodash": "^4.17.21",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^24.10.1",
+    "@types/node": "^25.0.3",
     "@types/supertest": "^6.0.3",
-    "chai": "^6.2.1",
+    "chai": "^6.2.2",
     "mocha": "^11.7.5",
-    "supertest": "^7.1.4",
+    "supertest": "^7.2.2",
     "terser": "^5.44.1",
     "ts-node": "^10.9.2",
     "tsx": "^4.21.0",