@formio/uag 1.13.2 → 2.0.0-rc.10

package/lib/tools/getFieldInfo.js

@@ -7,7 +7,7 @@ const SchemaBuilder_1 = require("./SchemaBuilder");
 const annotations_1 = require("./annotations");
 const error = require('debug')('formio:uag:getFieldInfo:error');
 const getFieldInfo = async (project) => {
-    return (0, lodash_1.defaultsDeep)(project.config?.toolOverrides?.get_field_info || {}, {
+    return (0, lodash_1.defaultsDeep)({}, project.config?.toolOverrides?.get_field_info, {
         name: 'get_field_info',
         title: 'Get Field(s) Info',
         description: 'Get detailed information about a specific field(s) that have been provided from the user. It is used to understand the properties, validation rules, and options of the specific field(s) the user has provided values for. This purpose of this tool is to provide detailed information for any field(s) (provided using the `field_paths` parameter) to help understand the structure and requirements of a form. PREREQUISITE: This tool should be called after the `get_form_fields` tool has been called AND once the user has provided some values for the provided fields.',

package/lib/tools/getFormFields.js

@@ -7,7 +7,7 @@ const SchemaBuilder_1 = require("./SchemaBuilder");
 const annotations_1 = require("./annotations");
 const error = require('debug')('formio:uag:getFormFields:error');
 const getFormFields = async (project) => {
-    return (0, lodash_1.defaultsDeep)(project.config?.toolOverrides?.get_form_fields || {}, {
+    return (0, lodash_1.defaultsDeep)({}, project.config?.toolOverrides?.get_form_fields, {
         name: 'get_form_fields',
         title: 'Get Form Fields',
         description: 'Get high level overview of the fields that are present in a form, and to understand the "rules" on how the data for each field type should be collected. The purpose of this tool is to determine what fields the user is requesting (and to understand how to format that values for that data), and use that to create a list of field data_path\'s that the user is providing context for. This list can then be provided to the `get_field_info` tool to determine the specific field level information for those fields (validation, required, collection rules, etc). PREREQUISITE: You must call the `get_forms` tool first to understand what forms are available to submit and the permissions associated with those forms.',

package/lib/tools/getForms.js

@@ -5,7 +5,7 @@ const lodash_1 = require("lodash");
 const template_1 = require("../template");
 const annotations_1 = require("./annotations");
 const getForms = async (project) => {
-    return (0, lodash_1.defaultsDeep)(project.config?.toolOverrides?.get_forms || {}, {
+    return (0, lodash_1.defaultsDeep)({}, project.config?.toolOverrides?.get_forms, {
         name: 'get_forms',
         title: 'Get Available Forms',
         description: 'Get a list of all available forms with their descriptions. Use this tool when a user expresses intent to add, create, submit, fill out, register for something (e.g., "I want to add a new Contact", "I need to submit a User Registration", "I met a contact who was the CMO", "What was the email of the contact"). This tool can also be used when they ask what forms are available.',

package/lib/tools/index.d.ts

@@ -8,8 +8,11 @@ import { findSubmission } from "./findSubmission";
 import { submissionUpdate } from "./submissionUpdate";
 import { ToolInfo } from "./utils";
 import { UAGProjectInterface } from "../UAGProjectInterface";
+import { agentProvide } from "./agentProvide";
+import { agentDecide } from "./agentDecide";
 import { fetchExternalData } from "./fetchExternalData";
+import { readDocument } from "./readDocument";
 export * from './utils';
 export * from './annotations';
-export { getForms, getFormFields, getFieldInfo, collectData, confirmSubmission, submitCompletedForm, findSubmission, submissionUpdate, fetchExternalData };
+export { getForms, getFormFields, getFieldInfo, collectData, confirmSubmission, submitCompletedForm, findSubmission, submissionUpdate, fetchExternalData, agentProvide, agentDecide, readDocument };
 export declare const getTools: (project: UAGProjectInterface) => Promise<ToolInfo[]>;

package/lib/tools/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTools = exports.fetchExternalData = exports.submissionUpdate = exports.findSubmission = exports.submitCompletedForm = exports.confirmSubmission = exports.collectData = exports.getFieldInfo = exports.getFormFields = exports.getForms = void 0;
+exports.getTools = exports.readDocument = exports.agentDecide = exports.agentProvide = exports.fetchExternalData = exports.submissionUpdate = exports.findSubmission = exports.submitCompletedForm = exports.confirmSubmission = exports.collectData = exports.getFieldInfo = exports.getFormFields = exports.getForms = void 0;
 const getForms_1 = require("./getForms");
 Object.defineProperty(exports, "getForms", { enumerable: true, get: function () { return getForms_1.getForms; } });
 const getFormFields_1 = require("./getFormFields");
@@ -31,23 +31,30 @@ const findSubmission_1 = require("./findSubmission");
 Object.defineProperty(exports, "findSubmission", { enumerable: true, get: function () { return findSubmission_1.findSubmission; } });
 const submissionUpdate_1 = require("./submissionUpdate");
 Object.defineProperty(exports, "submissionUpdate", { enumerable: true, get: function () { return submissionUpdate_1.submissionUpdate; } });
-const agentProvideData_1 = require("./agentProvideData");
+const agentProvide_1 = require("./agentProvide");
+Object.defineProperty(exports, "agentProvide", { enumerable: true, get: function () { return agentProvide_1.agentProvide; } });
+const agentDecide_1 = require("./agentDecide");
+Object.defineProperty(exports, "agentDecide", { enumerable: true, get: function () { return agentDecide_1.agentDecide; } });
 const fetchExternalData_1 = require("./fetchExternalData");
 Object.defineProperty(exports, "fetchExternalData", { enumerable: true, get: function () { return fetchExternalData_1.fetchExternalData; } });
+const readDocument_1 = require("./readDocument");
+Object.defineProperty(exports, "readDocument", { enumerable: true, get: function () { return readDocument_1.readDocument; } });
 __exportStar(require("./utils"), exports);
 __exportStar(require("./annotations"), exports);
 const getTools = async (project) => {
-    return [
-        await (0, getForms_1.getForms)(project),
-        await (0, getFormFields_1.getFormFields)(project),
-        await (0, getFieldInfo_1.getFieldInfo)(project),
-        await (0, collectData_1.collectData)(project),
-        await (0, confirmSubmission_1.confirmSubmission)(project),
-        await (0, submitForm_1.submitCompletedForm)(project),
-        await (0, findSubmission_1.findSubmission)(project),
-        await (0, submissionUpdate_1.submissionUpdate)(project),
-        await (0, agentProvideData_1.agentProvideData)(project),
-        await (0, fetchExternalData_1.fetchExternalData)(project)
-    ];
+    return Promise.all([
+        (0, getForms_1.getForms)(project),
+        (0, getFormFields_1.getFormFields)(project),
+        (0, getFieldInfo_1.getFieldInfo)(project),
+        (0, collectData_1.collectData)(project),
+        (0, confirmSubmission_1.confirmSubmission)(project),
+        (0, submitForm_1.submitCompletedForm)(project),
+        (0, findSubmission_1.findSubmission)(project),
+        (0, submissionUpdate_1.submissionUpdate)(project),
+        (0, agentProvide_1.agentProvide)(project),
+        (0, agentDecide_1.agentDecide)(project),
+        (0, fetchExternalData_1.fetchExternalData)(project),
+        (0, readDocument_1.readDocument)(project)
+    ]);
 };
 exports.getTools = getTools;

package/lib/tools/readDocument.d.ts

@@ -0,0 +1,17 @@
+import type { UAGProjectInterface } from '../UAGProjectInterface';
+import { ToolInfo } from './utils';
+/**
+ * read_document's limits: the largest file it reads (`documents.maxFileBytes`,
+ * else DOCUMENTS_MAX_FILE_BYTES, 25 MB), and the most characters of text it
+ * returns (`agentApi.files.maxChars`, as task inputs are cut, 200000).
+ */
+export declare function readDocumentLimits(config: any, env?: NodeJS.ProcessEnv): {
+    maxBytes: number;
+    maxChars: number;
+};
+/**
+ * read_document: the text of an uploaded document in a submission (a file in a
+ * file component, or in an AI Document's files), read through the installed
+ * converters with the caller's identity. Read-only.
+ */
+export declare const readDocument: (project: UAGProjectInterface) => Promise<ToolInfo>;

package/lib/tools/readDocument.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readDocument = void 0;
+exports.readDocumentLimits = readDocumentLimits;
+const zod_1 = __importDefault(require("zod"));
+const lodash_1 = require("lodash");
+const core_1 = require("@formio/core");
+const template_1 = require("../template");
+const annotations_1 = require("./annotations");
+const readers_1 = require("../documents/readers");
+const DEFAULT_MAX_FILE_BYTES = 25 * 1024 * 1024;
+const DEFAULT_MAX_CHARS = 200000;
+const positive = (value) => (Number(value) > 0 ? Number(value) : undefined);
+/**
+ * read_document's limits: the largest file it reads (`documents.maxFileBytes`,
+ * else DOCUMENTS_MAX_FILE_BYTES, 25 MB), and the most characters of text it
+ * returns (`agentApi.files.maxChars`, as task inputs are cut, 200000).
+ */
+function readDocumentLimits(config, env = process.env) {
+    return {
+        maxBytes: positive(config?.documents?.maxFileBytes) || positive(env.DOCUMENTS_MAX_FILE_BYTES) || DEFAULT_MAX_FILE_BYTES,
+        maxChars: positive(config?.agentApi?.files?.maxChars) || DEFAULT_MAX_CHARS
+    };
+}
+/** The component at a data path, row indices removed (`rows[2].contract` is `rows.contract`). */
+function componentAt(components, dataPath) {
+    const path = dataPath.replace(/\[\d+\]/g, '');
+    let found;
+    // The data path: with every component included, the second argument also names layout components (panels, columns).
+    core_1.Utils.eachComponent(components, (component, componentPath, _components, _parent, paths) => {
+        if (!found && (paths?.path ?? componentPath) === path)
+            found = component;
+    }, true);
+    return found;
+}
+/**
+ * read_document: the text of an uploaded document in a submission (a file in a
+ * file component, or in an AI Document's files), read through the installed
+ * converters with the caller's identity. Read-only.
+ */
+const readDocument = async (project) => {
+    return (0, lodash_1.defaultsDeep)({}, project.config?.toolOverrides?.read_document, {
+        name: 'read_document',
+        title: 'Read Uploaded Document',
+        description: 'Read the text of a document uploaded to a submission: a file in a file field, or in an AI Document field. ' +
+            'Give the form, the submission id (from `find_submissions`) and the data path of the field (such as "contract" or "rows[0].attachment"; ' +
+            'add an index, such as "contract[1]", for another file than the first). Returns the file name, its type, its page count when known, and its text; ' +
+            'a long text is cut, and `truncated` is true.',
+        annotations: (0, annotations_1.reads)('Read an uploaded document'),
+        inputSchema: {
+            form_name: zod_1.default.string().describe('The name of the form, as `get_forms` lists it.'),
+            submission_id: zod_1.default.string().describe('The full ID of the submission, as `find_submissions` gives it.'),
+            data_path: zod_1.default.string().describe('The data path of the file field or AI Document field.')
+        },
+        execute: async ({ form_name, submission_id, data_path }, extra) => {
+            const form = await project.getForm(form_name);
+            if (!form) {
+                return project.mcpResponse(template_1.ResponseTemplate.formNotFound, { formName: form_name }, true);
+            }
+            const submission = await form.loadSubmission(submission_id, extra.authInfo);
+            if (!submission) {
+                return project.mcpResponse(template_1.ResponseTemplate.submissionNotFound, { submissionId: submission_id, form: form.form }, true);
+            }
+            // An index on the last segment picks a file of a multiple field: contract[1].
+            const index = /\[(\d+)\]$/.exec(data_path);
+            const fieldPath = index ? data_path.slice(0, index.index) : data_path;
+            const value = (0, lodash_1.get)(submission.data, fieldPath);
+            const isDocument = value && typeof value === 'object' && !Array.isArray(value) && Array.isArray(value.files);
+            const files = isDocument ? value.files : Array.isArray(value) ? value : (value && typeof value === 'object' ? [value] : []);
+            const file = files[index ? Number(index[1]) : 0];
+            const component = componentAt(form.form?.components || [], isDocument ? `${fieldPath}.files` : fieldPath);
+            if (!file || !component || component.type !== 'file') {
+                return project.mcpJSONResponse({ error: `No uploaded file at "${data_path}" in that submission. Give the data path of a file field or an AI Document field.` }, true);
+            }
+            if (!project.plugins) {
+                return project.mcpJSONResponse({ error: 'Documents cannot be read until the server has started.' }, true);
+            }
+            const limits = readDocumentLimits(project.config);
+            try {
+                const buffer = await form.readFile(file, extra.authInfo, { maxBytes: limits.maxBytes, component });
+                if (!buffer) {
+                    return project.mcpJSONResponse({ error: `The file is stored as ${file.storage || 'unknown'}, which cannot be read here.` }, true);
+                }
+                const name = String(file.originalName || file.name || 'file');
+                const read = await (0, readers_1.readAsText)(project.plugins, buffer, { name, type: typeof file.type === 'string' ? file.type : undefined }, { signal: extra?.signal });
+                const truncated = read.text.length > limits.maxChars;
+                return project.mcpJSONResponse({ file_name: name, type: read.type, pages: read.pages ?? null, text: truncated ? read.text.slice(0, limits.maxChars) : read.text, truncated });
+            }
+            catch (err) {
+                // The message names the file and the reason, never its content.
+                return project.mcpJSONResponse({ error: err?.message || 'The file could not be read.' }, true);
+            }
+        }
+    });
+};
+exports.readDocument = readDocument;

package/lib/tools/submissionUpdate.js

@@ -7,7 +7,7 @@ const SchemaBuilder_1 = require("./SchemaBuilder");
 const annotations_1 = require("./annotations");
 const error = require('debug')('formio:uag:submissionUpdate:error');
 const submissionUpdate = async (project) => {
-    return (0, lodash_1.defaultsDeep)(project.config?.toolOverrides?.submission_update || {}, {
+    return (0, lodash_1.defaultsDeep)({}, project.config?.toolOverrides?.submission_update, {
         name: 'submission_update',
         title: 'Submission Update',
         description: 'Apply multiple planned field updates to a selected submission after the user confirmed they wish to update the record.',
@@ -35,10 +35,11 @@ const submissionUpdate = async (project) => {
                 const updateSummary = [];
                 for (const update of updates) {
                     const previousValue = (0, lodash_1.get)(updatedData, update.data_path);
-                    (0, lodash_1.set)(updatedData, update.data_path, update.new_value);
+                    const newValue = form.normalizeWrittenValue(update.data_path, update.new_value);
+                    (0, lodash_1.set)(updatedData, update.data_path, newValue);
                     updateSummary.push({
                         data_path: update.data_path,
-                        new_value: update.new_value,
+                        new_value: newValue,
                         previous_value: previousValue || ''
                     });
                 }

package/lib/tools/submitForm.js

@@ -7,7 +7,7 @@ const SchemaBuilder_1 = require("./SchemaBuilder");
 const annotations_1 = require("./annotations");
 const debug = require('debug')('formio:uag:submitForm');
 const submitCompletedForm = async (project) => {
-    return (0, lodash_1.defaultsDeep)(project.config?.toolOverrides?.submit_completed_form || {}, {
+    return (0, lodash_1.defaultsDeep)({}, project.config?.toolOverrides?.submit_completed_form, {
         name: 'submit_completed_form',
         title: 'Submit Completed Form',
         description: 'Submit the completed form data. Should only be used once all the required fields have been collected, and the user has explicitly confirmed submission (e.g. has said "submit", "send", "done", etc)',

package/lib/tools/utils.d.ts

@@ -1,5 +1,7 @@
 import { ZodRawShape } from "zod";
 import { ToolAnnotations } from "./annotations";
+import type { AuthRequest } from "@formio/appserver";
+import type { UAGProjectInterface } from "../UAGProjectInterface";
 /**
  * Escape a literal value so it can be carried in a `__regex` query parameter.
  *
@@ -20,14 +22,52 @@ import { ToolAnnotations } from "./annotations";
  * @returns The value as a regular expression pattern that matches it literally.
  */
 export declare const escapeSearchPattern: (value: string) => string;
+/**
+ * What a tool's `execute` receives besides its arguments, on every path that
+ * runs it: MCP clients on `/mcp`, and Agent API research in process.
+ */
+export type ToolExtra = {
+    /** The caller's identity: who the work runs as. Pass it to form methods so Form.io applies its permissions. */
+    authInfo: AuthRequest;
+    /** The project serving the request. */
+    project: UAGProjectInterface;
+    /** For a tool from a module with a name and an apiVersion: the module's API (its settings, engines, ...). */
+    module?: import('../modules').UAGModuleApi;
+    /** On `/mcp`, the rest of the MCP SDK's request context (signal, request id, ...). */
+    [key: string]: any;
+};
 export type ToolInfo = {
     name?: string;
     title?: string;
     description?: string;
     inputSchema?: ZodRawShape | undefined;
     annotations?: ToolAnnotations;
+    /**
+     * Runs the tool: always called with its arguments (an empty object when it
+     * takes none), then a `ToolExtra`. Typed loosely so existing tools and their
+     * callers keep compiling; annotate `extra` as `ToolExtra` in your own tools.
+     */
     execute?: any;
+    /**
+     * Builds the project-specific part of the tool (`inputSchema`, `annotations`,
+     * `execute`, ...) for a project, as the built-in tools are built. The static
+     * `name`, `title` and `description` are used unless `bind` returns its own,
+     * so the tool's name is known without a project. Called whenever the tool
+     * list is built (every `/mcp` request and every research plan): keep it
+     * cheap, and load libraries and other slow state once, outside it.
+     */
+    bind?: (project: UAGProjectInterface) => Partial<ToolInfo> | Promise<Partial<ToolInfo>>;
 };
+/** An entry of `config.tools`: a tool, optionally bound to the project with `bind`. */
+export type ToolEntry = ToolInfo;
+/** The shape a `config.tools` entry takes, shown when one is a bare function. */
+export declare const BOUND_TOOL_SHAPE = "{ name: 'my_tool', title: 'My Tool', description: '...', bind(project) { return { inputSchema, annotations, execute }; } }";
+/**
+ * Refuse `config.tools` entries that are bare functions (the unreleased factory
+ * form): a tool is an object, whose `bind(project)` builds its project-specific
+ * part. Throws naming the entry and showing the shape.
+ */
+export declare function assertToolEntries(entries: unknown[] | undefined): void;
 export type ParentInfo = {
     type: string;
     label?: string;

package/lib/tools/utils.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.escapeSearchPattern = void 0;
+exports.BOUND_TOOL_SHAPE = exports.escapeSearchPattern = void 0;
+exports.assertToolEntries = assertToolEntries;
 const lodash_1 = require("lodash");
 /**
  * Escape a literal value so it can be carried in a `__regex` query parameter.
@@ -23,3 +24,17 @@ const lodash_1 = require("lodash");
  */
 const escapeSearchPattern = (value) => (0, lodash_1.escapeRegExp)(value).replace(/\//g, '\\x2f');
 exports.escapeSearchPattern = escapeSearchPattern;
+/** The shape a `config.tools` entry takes, shown when one is a bare function. */
+exports.BOUND_TOOL_SHAPE = "{ name: 'my_tool', title: 'My Tool', description: '...', bind(project) { return { inputSchema, annotations, execute }; } }";
+/**
+ * Refuse `config.tools` entries that are bare functions (the unreleased factory
+ * form): a tool is an object, whose `bind(project)` builds its project-specific
+ * part. Throws naming the entry and showing the shape.
+ */
+function assertToolEntries(entries) {
+    (entries || []).forEach((entry, index) => {
+        if (typeof entry === 'function') {
+            throw new Error(`config.tools[${index}] is a function. A custom tool is an object; build its project-specific part with bind(project): ${exports.BOUND_TOOL_SHAPE}`);
+        }
+    });
+}

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": "1.13.2",
+  "version": "2.0.0-rc.10",
   "mcpName": "io.form/formio-uag",
   "description": "The Form.io Universal Agent Gateway (UAG).",
   "main": "lib/index.js",
@@ -9,19 +9,35 @@
     "node": ">=22.0.0"
   },
   "files": [
-    "lib"
+    "lib",
+    "bin",
+    "testing.js",
+    "testing.d.ts"
+  ],
+  "workspaces": [
+    "engines/*",
+    "packages/*",
+    "demo"
   ],
   "scripts": {
     "clean": "rm -rf lib",
     "build:ts": "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",
+    "prepublishOnly": "npm run build && node scripts/check-release.mjs",
     "build:docker": "docker build -t formio/uag$(node -p \"require('./package.json').version.includes('-rc.') ? ':rc' : ''\") --platform=linux/amd64 .",
     "test": "tsc --noEmit -p tsconfig.test.json && mocha --no-node-snapshot",
     "test:e2e": "mocha --config .mocharc.e2e.json",
+    "test:getting-started": "mocha --no-config --node-option no-node-snapshot --require dotenv/config --timeout 1800000 test/e2e/layer3.getting-started.e2e.mjs",
+    "release": "node scripts/release.mjs",
+    "release:version": "node scripts/set-version.mjs",
     "dev": "tsx --no-node-snapshot index.js",
-    "start": "node --no-node-snapshot index.js",
-    "claude": "node --no-node-snapshot ./integrations/claude/index.js"
+    "demo:build": "node demo/scripts/build.mjs",
+    "demo:dev": "node --no-node-snapshot demo/scripts/dev.mjs",
+    "demo:local": "node --no-node-snapshot demo/scripts/local.mjs",
+    "demo:start": "node --no-node-snapshot demo/scripts/start.mjs",
+    "demo:record": "node --no-node-snapshot demo/recordings/record.mjs",
+    "start": "node --no-node-snapshot index.js"
   },
   "repository": {
     "type": "git",
@@ -30,18 +46,24 @@
   "author": "Form.io Developers",
   "license": "MIT",
   "dependencies": {
-    "@formio/appserver": "^2.14.1",
-    "@formio/core": "2.8.0",
-    "@modelcontextprotocol/sdk": "1.30.0",
+    "@formio/appserver": "^2.26.4",
+    "@formio/core": "2.9.0",
+    "@formio/uag-sdk": "^2.0.0-rc.10",
+    "@modelcontextprotocol/sdk": "1.32.2",
     "cors": "^2.8.6",
     "debug": "^4.4.3",
-    "dotenv": "^17.4.2",
-    "express": "^5.2.1",
+    "dotenv": "^18.0.9",
+    "express": "^5.3.0",
     "jsonwebtoken": "^9.0.3",
     "lodash": "^4.18.1",
+    "markdown-it": "^15.0.3",
+    "mongodb": "^7.7.0",
     "node-cache": "^5.1.2",
     "node-html-markdown": "^2.0.0",
-    "zod": "^4.4.3"
+    "node-html-parser": "^9.0.5",
+    "pdf-lib": "^1.17.1",
+    "unpdf": "^2.1.0",
+    "zod": "^4.6.7"
   },
   "resolutions": {
     "tar": ">=7.5.12",
@@ -52,22 +74,26 @@
     "dompurify": ">=3.3.3"
   },
   "devDependencies": {
-    "@anthropic-ai/sdk": "^0.115.0",
+    "@anthropic-ai/sdk": "^1.3.0",
+    "@formio/js": "5.7.0",
     "@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",
-    "@types/lodash": "^4.17.25",
+    "@types/lodash": "^4.17.27",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^26.1.2",
+    "@types/node": "^26.6.6",
     "@types/supertest": "^7.2.1",
-    "chai": "^6.2.2",
-    "mocha": "^11.8.0",
-    "supertest": "^7.2.2",
-    "terser": "^5.49.1",
-    "tsx": "^4.23.5",
+    "chai": "^6.3.0",
+    "jsdom": "30.1.3",
+    "mocha": "^12.0.3",
+    "mongodb-memory-server": "^11.3.0",
+    "playwright": "1.64.1",
+    "supertest": "^7.3.1",
+    "terser": "^5.51.2",
+    "tsx": "^4.23.15",
     "typescript": "^7.0.2"
   },
   "packageManager": "yarn@4.17.1",
@@ -78,5 +104,9 @@
     "isolated-vm": {
       "built": true
     }
+  },
+  "bin": {
+    "uag": "bin/uag.js",
+    "uag-eval": "bin/uag-eval.js"
   }
 }

package/testing.d.ts

@@ -0,0 +1 @@
+export * from './lib/testing';

package/testing.js

@@ -0,0 +1,2 @@
+// @formio/uag/testing: test a module without a Form.io project or a running UAG.
+module.exports = require('./lib/testing');

package/lib/tools/agentProvideData.d.ts

@@ -1,3 +0,0 @@
-import { UAGProjectInterface } from "../UAGProjectInterface";
-import { ToolInfo } from "./utils";
-export declare const agentProvideData: (project: UAGProjectInterface) => Promise<ToolInfo>;

package/lib/tools/agentProvideData.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.agentProvideData = void 0;
-const template_1 = require("../template");
-const lodash_1 = require("lodash");
-const SchemaBuilder_1 = require("./SchemaBuilder");
-const annotations_1 = require("./annotations");
-const agentProvideData = async (project) => {
-    return (0, lodash_1.defaultsDeep)(project.config?.toolOverrides?.agent_provide_data || {}, {
-        name: 'agent_provide_data',
-        title: 'Agent Provide Data',
-        description: 'Provides a mechanism for agents to process existing submission data, understand it, and then to provide additional data values provided a criteria and form context.',
-        annotations: (0, annotations_1.reads)('Process submission data'),
-        inputSchema: (new SchemaBuilder_1.SchemaBuilder(project))
-            .form_name()
-            .submission_id()
-            .persona().schema,
-        execute: async ({ form_name, submission_id, persona }, extra) => {
-            const form = await project.getForm(form_name);
-            if (!form) {
-                return project.mcpResponse(template_1.ResponseTemplate.formNotFound, { formName: form_name }, true);
-            }
-            const uag = persona ? form.uagFields[persona] : Object.values(form.uagFields)[0];
-            if (!uag) {
-                return project.mcpResponse(template_1.ResponseTemplate.uagComponentNotFound, {
-                    persona: persona || 'default',
-                    error: 'no_uag'
-                }, true);
-            }
-            const submission = await form.loadSubmission(submission_id, extra.authInfo);
-            if (!submission) {
-                return project.mcpResponse(template_1.ResponseTemplate.submissionNotFound, {
-                    form: form.form,
-                    submissionId: submission_id
-                }, true);
-            }
-            if (!uag.criteria) {
-                return project.mcpResponse(template_1.ResponseTemplate.uagComponentNotFound, {
-                    persona: persona || 'default',
-                    error: 'no_criteria'
-                }, true);
-            }
-            const agentFields = Object.values(uag.components);
-            if (agentFields.length === 0) {
-                return project.mcpResponse(template_1.ResponseTemplate.uagComponentNotFound, {
-                    persona: persona || 'default',
-                    error: 'no_fields'
-                }, true);
-            }
-            // Collect more required fields.
-            return project.mcpResponse(template_1.ResponseTemplate.agentProcessData, {
-                persona: persona || 'default',
-                criteria: uag.criteria,
-                values: project.uagTemplate?.renderTemplate(template_1.ResponseTemplate.fieldValues, {
-                    data: form.formatData(submission.data)
-                }),
-                fields: project.uagTemplate?.renderTemplate(template_1.ResponseTemplate.fieldList, { fields: agentFields })
-            });
-        }
-    });
-};
-exports.agentProvideData = agentProvideData;