@formio/uag 2.0.0-rc.4 → 2.0.0-rc.6

package/README.md

@@ -90,7 +90,7 @@ services:
       retries: 40
 
   formio-uag:
-    image: formio/uag
+    image: formio/uag:rc
     depends_on:
       formio: { condition: service_healthy }
     ports: ["3200:3200"]
@@ -267,7 +267,7 @@ app.use(await server.router());
 app.listen(process.env.PORT || 3200);
 ```
 
-Run Node 22 or newer with `--no-node-snapshot` (isolated-vm, which runs form logic, needs it), and install the engines you use next to the UAG (`npm install @formio/uag-claude`). See [Node.js API](https://ai.form.io/developers/node-api).
+Run Node 22 or newer with `--no-node-snapshot` (isolated-vm, which runs form logic, needs it), and install the engines you use next to the UAG (`npm install @formio/uag-claude@rc`). See [Node.js API](https://ai.form.io/developers/node-api).
 - **[`@formio/uag-js`](./packages/uag-js)** connects a formio.js application to the UAG. Register it once with `Formio.use(UAG('https://uag.example.com'))`: submissions of forms tagged `uag` are then saved through the UAG, and Agent Input fills those forms from what the user wrote, through `{form}/agent/extract`, when they leave the input, pause, move to the next page, or press a button. `Formio.createChat(element, formUrl)` renders any of them as a chat instead, templated, translated and themed like a formio.js form. See [JavaScript (formio.js)](https://ai.form.io/developers/renderer) and [Chat widget](https://ai.form.io/developers/chat).
 
 ## Deployment

package/lib/UAGProjectInterface.js

@@ -12,6 +12,7 @@ const express_1 = require("express");
 const router_1 = require("./router");
 const template_1 = require("./template");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const version_1 = require("./version");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const router_2 = require("./agent/router");
 const tools_1 = require("./agent/tools");
@@ -28,7 +29,7 @@ class UAGProjectInterface extends appserver_1.ProjectInterface {
         this.uagTemplate = null;
         /** Engines enabled at startup; empty until UAGServer.router() resolves them. */
         this.engines = new formflow_1.EngineRegistry();
-        this.mcpServer = new mcp_js_1.McpServer({ name: 'formio-uag', version: '1.0.0' });
+        this.mcpServer = new mcp_js_1.McpServer({ name: 'formio-uag', version: version_1.UAG_VERSION });
     }
     async initialize() {
         await super.initialize();
@@ -40,7 +41,7 @@ class UAGProjectInterface extends appserver_1.ProjectInterface {
     // A scoped token narrows the tools to its own list, and only ever to tools
     // annotated read-only: no model may write through /mcp with one.
     async buildMcpServer(scope) {
-        const server = new mcp_js_1.McpServer({ name: 'formio-uag', version: '1.0.0' });
+        const server = new mcp_js_1.McpServer({ name: 'formio-uag', version: version_1.UAG_VERSION });
         // The standard UAG tools, plus the custom tools from config.
         let tools = await (0, tools_1.allTools)(this);
         if (scope) {

package/lib/index.d.ts

@@ -10,7 +10,7 @@ export type UAGModule = ServerModule & {
 /**
  * Agentic Formflow keeps its license state inside @formio/appserver-core. The UAG
  * loads it only through @formio/appserver, so the two always share one copy,
- * which must be 2.25.1 or later. An older @formio/appserver, or an old lockfile,
+ * which must be 2.25.2 or later. An older @formio/appserver, or an old lockfile,
  * can still resolve an older one, which would fail in confusing ways; say what
  * to do instead.
  */

package/lib/index.js

@@ -36,18 +36,19 @@ const runs_1 = require("./runs");
 const actionLogs_1 = require("./actionLogs");
 const runner_1 = require("./runner");
 const runTask_1 = require("./actions/runTask");
+const version_1 = require("./version");
 const debug = require('debug')('formio:uag');
 /**
  * Agentic Formflow keeps its license state inside @formio/appserver-core. The UAG
  * loads it only through @formio/appserver, so the two always share one copy,
- * which must be 2.25.1 or later. An older @formio/appserver, or an old lockfile,
+ * which must be 2.25.2 or later. An older @formio/appserver, or an old lockfile,
  * can still resolve an older one, which would fail in confusing ways; say what
  * to do instead.
  */
 function assertSingleCore(version = appserverCoreVersion()) {
     const [major, minor, patch] = version.split('.').map((part) => parseInt(part, 10) || 0);
-    if (major < 2 || (major === 2 && (minor < 25 || (minor === 25 && patch < 1)))) {
-        throw new Error(`@formio/uag needs @formio/appserver-core 2.25.1 or later, through @formio/appserver; ${version} is installed. Upgrade @formio/appserver.`);
+    if (major < 2 || (major === 2 && (minor < 25 || (minor === 25 && patch < 2)))) {
+        throw new Error(`@formio/uag needs @formio/appserver-core 2.25.2 or later, through @formio/appserver; ${version} is installed. Upgrade @formio/appserver.`);
     }
 }
 /** The version of the @formio/appserver-core that @formio/appserver loads. */
@@ -129,6 +130,8 @@ class UAGServer extends appserver_1.Server {
             retryDelay: parseInt((0, lodash_1.get)(process.env, 'PROJECT_RETRY_DELAY', 5000).toString(), 10),
             submissionProxy: true,
             processAsClient: true,
+            // GET /status names the UAG's version beside the Form.io packages it runs on.
+            status: { '@formio/uag': version_1.UAG_VERSION },
             // Bodies are parsed before authentication, so keep them to what Form.io accepts.
             maxBodySize: (0, lodash_1.get)(process.env, 'MAX_BODY_SIZE', '16mb').toString(),
             auth: { pkce: true, mcpOAuth: (0, lodash_1.get)(process.env, 'MCP_OAUTH', '').toString() === 'true' },

package/lib/tools/collectData.js

@@ -34,7 +34,8 @@ const collectData = async (project) => {
             const fields = await form.getFields(submission, extra.authInfo, parent?.data_path);
             if (fields.errors.length > 0) {
                 if (as_json) {
-                    return project.mcpJSONResponse(fields.errors);
+                    // structuredContent must be an object: an MCP client refuses a bare array.
+                    return project.mcpJSONResponse({ errors: fields.errors }, true);
                 }
                 return project.mcpResponse(template_1.ResponseTemplate.fieldValidationErrors, { invalidFields: fields.errors });
             }

package/lib/version.d.ts

@@ -0,0 +1,2 @@
+/** The UAG's own version, from its package.json (src/ and lib/ both sit one level below it). */
+export declare const UAG_VERSION: string;

package/lib/version.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UAG_VERSION = void 0;
+/** The UAG's own version, from its package.json (src/ and lib/ both sit one level below it). */
+exports.UAG_VERSION = require('../package.json').version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formio/uag",
-  "version": "2.0.0-rc.4",
+  "version": "2.0.0-rc.6",
   "mcpName": "io.form/formio-uag",
   "description": "The Form.io Universal Agent Gateway (UAG).",
   "main": "lib/index.js",
@@ -43,9 +43,9 @@
   "author": "Form.io Developers",
   "license": "MIT",
   "dependencies": {
-    "@formio/appserver": "^2.25.1",
+    "@formio/appserver": "^2.25.2",
     "@formio/core": "2.9.0",
-    "@formio/uag-sdk": "^2.0.0-rc.4",
+    "@formio/uag-sdk": "^2.0.0-rc.6",
     "@modelcontextprotocol/sdk": "1.32.2",
     "cors": "^2.8.6",
     "debug": "^4.4.3",
@@ -72,7 +72,6 @@
     "@types/chai": "^5.2.3",
     "@types/cors": "^2.8.19",
     "@types/debug": "^4.1.13",
-    "@types/dotenv": "^8.2.3",
     "@types/express": "^5.0.6",
     "@types/jsdom": "^30.0.0",
     "@types/jsonwebtoken": "^9.0.10",