@formio/uag 1.13.2 → 2.0.0-rc.1

package/lib/tools/agentProvide.d.ts

@@ -0,0 +1,13 @@
+import { UAGProjectInterface } from "../UAGProjectInterface";
+import { ToolInfo } from "./utils";
+/**
+ * `agent_provide`: a task's criteria, the submission's values and the task's
+ * fields, as instructions for an agent to fill those fields. It reads only; the
+ * agent writes its values with `submission_update`.
+ */
+export declare const agentProvide: (project: UAGProjectInterface) => Promise<ToolInfo>;
+/**
+ * `agent_provide_data`: the earlier name of `agent_provide`, kept so MCP clients
+ * and integrations that call it keep working. Removed in a future major release.
+ */
+export declare const agentProvideData: (project: UAGProjectInterface) => Promise<ToolInfo>;

package/lib/tools/agentProvide.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentProvideData = exports.agentProvide = void 0;
+const template_1 = require("../template");
+const lodash_1 = require("lodash");
+const SchemaBuilder_1 = require("./SchemaBuilder");
+const annotations_1 = require("./annotations");
+const formflow_1 = require("../formflow");
+const 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.';
+/**
+ * Agentic workflow over MCP is Agentic Formflow: it needs a license or a project
+ * on Form.io's hosted service, as the Agent API does. The stub engines do not
+ * count, since this tool calls no engine. Answers the refusal, or null.
+ */
+async function refusal(project) {
+    const state = await (0, formflow_1.formflow)(project).state();
+    if (state.allowed && (state.reason === 'licensed' || state.reason === 'hosted'))
+        return null;
+    return {
+        error: 'Agentic workflows require a license (LICENSE_KEY) that includes the UAG (an online license with UAG servers, or an offline license ' +
+            'with the "uag" option), or a project on Form.io\'s hosted service. ' +
+            'MCP tools and conversation forms do not need either.',
+        code: 'license_required',
+    };
+}
+/**
+ * `agent_provide`: a task's criteria, the submission's values and the task's
+ * fields, as instructions for an agent to fill those fields. It reads only; the
+ * agent writes its values with `submission_update`.
+ */
+const agentProvide = async (project) => {
+    // Overrides written for the tool's earlier name still apply, except a rename,
+    // which belongs to the deprecated tool and would clash with it.
+    const overrides = project.config?.toolOverrides;
+    const own = overrides?.agent_provide || (overrides?.agent_provide_data ? (0, lodash_1.omit)(overrides.agent_provide_data, 'name') : {});
+    // Merged into a new object: the overrides are shared config, and the tools are
+    // built again for every request.
+    return (0, lodash_1.defaultsDeep)({}, own, provideTool(project, 'agent_provide'));
+};
+exports.agentProvide = agentProvide;
+/**
+ * `agent_provide_data`: the earlier name of `agent_provide`, kept so MCP clients
+ * and integrations that call it keep working. Removed in a future major release.
+ */
+const agentProvideData = async (project) => {
+    const tool = provideTool(project, 'agent_provide_data');
+    const execute = tool.execute;
+    return (0, lodash_1.defaultsDeep)({}, project.config?.toolOverrides?.agent_provide_data, {
+        ...tool,
+        title: 'Agent Provide Data (deprecated)',
+        description: `Deprecated: use \`agent_provide\`, which takes the same arguments. ${DESCRIPTION}`,
+        execute: (args, extra) => {
+            (0, formflow_1.warnLegacy)('agent_provide_data', 'the agent_provide_data MCP tool; use agent_provide.');
+            return execute(args, extra);
+        }
+    });
+};
+exports.agentProvideData = agentProvideData;
+function provideTool(project, name) {
+    return {
+        name,
+        title: 'Agent Provide',
+        description: DESCRIPTION,
+        annotations: (0, annotations_1.reads)('Process submission data'),
+        inputSchema: (new SchemaBuilder_1.SchemaBuilder(project))
+            .form_name()
+            .submission_id()
+            .task()
+            .persona().schema,
+        execute: async (args, extra) => {
+            const { form_name, submission_id } = args;
+            const refused = await refusal(project);
+            if (refused)
+                return project.mcpJSONResponse(refused, true);
+            let requested;
+            try {
+                requested = (0, formflow_1.resolveTaskName)(args, name);
+            }
+            catch (err) {
+                if (err instanceof formflow_1.FormflowError)
+                    return project.mcpJSONResponse({ error: err.message }, true);
+                throw err;
+            }
+            const form = await project.getForm(form_name);
+            if (!form) {
+                return project.mcpResponse(template_1.ResponseTemplate.formNotFound, { formName: form_name }, true);
+            }
+            const task = requested || Object.keys(form.uagFields)[0] || 'default';
+            // Templates get the task under both names: deployments may have
+            // customized a template that still renders `persona`.
+            const names = { task, persona: task };
+            const uag = form.uagFields[task];
+            if (!uag) {
+                return project.mcpResponse(template_1.ResponseTemplate.uagComponentNotFound, {
+                    ...names,
+                    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, {
+                    ...names,
+                    error: 'no_criteria'
+                }, true);
+            }
+            const agentFields = Object.values(uag.components);
+            if (agentFields.length === 0) {
+                return project.mcpResponse(template_1.ResponseTemplate.uagComponentNotFound, {
+                    ...names,
+                    error: 'no_fields'
+                }, true);
+            }
+            // Collect more required fields.
+            return project.mcpResponse(template_1.ResponseTemplate.agentProcessData, {
+                ...names,
+                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 })
+            });
+        }
+    };
+}

package/lib/tools/collectData.js

@@ -6,7 +6,7 @@ const lodash_1 = require("lodash");
 const SchemaBuilder_1 = require("./SchemaBuilder");
 const annotations_1 = require("./annotations");
 const collectData = async (project) => {
-    return (0, lodash_1.defaultsDeep)(project.config?.toolOverrides?.collect_field_data || {}, {
+    return (0, lodash_1.defaultsDeep)({}, project.config?.toolOverrides?.collect_field_data, {
         name: 'collect_field_data',
         title: 'Collect Field Data',
         description: 'Collect data for a form, or a specific field with nested components. Identify the component by its path, validate the provided value, and update the form_data object. After updating, determine the next required field to collect or indicate if all required fields are complete. PREREQUISITE: This tool should only be called after the `get_form_fields` tool AND subsequentially the `get_field_info` tool have been called to understand the structure and validation rules of the fields.',

package/lib/tools/confirmSubmission.js

@@ -6,7 +6,7 @@ const lodash_1 = require("lodash");
 const SchemaBuilder_1 = require("./SchemaBuilder");
 const annotations_1 = require("./annotations");
 const confirmSubmission = async (project) => {
-    return (0, lodash_1.defaultsDeep)(project.config?.toolOverrides?.confirm_form_submission || {}, {
+    return (0, lodash_1.defaultsDeep)({}, project.config?.toolOverrides?.confirm_form_submission, {
         name: 'confirm_form_submission',
         title: 'Confirm Form Submission',
         description: 'Show a summary of the collected form data if the user wishes to see a summary of the collected data',

package/lib/tools/fetchExternalData.js

@@ -41,9 +41,10 @@ function extractValue(item, component) {
 }
 /**
  * Check if a component is a select-type component with external data (url or resource).
+ * A radio can load its options from a URL too.
  */
 function isExternalSelect(component) {
-    if (component.type !== 'select' && component.type !== 'selectboxes')
+    if (component.type !== 'select' && component.type !== 'selectboxes' && component.type !== 'radio')
         return false;
     const dataSrc = component.dataSrc;
     return dataSrc === 'url' || dataSrc === 'resource';
@@ -71,7 +72,7 @@ function interpolateHeaders(headers, context) {
     return result;
 }
 const fetchExternalData = async (project) => {
-    return (0, lodash_1.defaultsDeep)(project.config?.toolOverrides?.fetch_external_data || {}, {
+    return (0, lodash_1.defaultsDeep)({}, project.config?.toolOverrides?.fetch_external_data, {
         name: 'fetch_external_data',
         title: 'Fetch External Data',
         description: 'Fetch external data for a component that loads data from an external URL, a Form.io Resource, or a DataSource. Use this tool when `get_form_fields` indicates that a field requires calling `fetch_external_data` to retrieve its data. For select components, this returns the available options. For datasource components, this returns the fetched data. You can optionally provide a `search_value` to filter results server-side. If the component\'s URL or headers contain interpolation tokens (e.g. `{{ data.someField }}`), you MUST provide `form_data` with the current collected data so the tokens can be resolved.',
@@ -123,24 +124,14 @@ const fetchExternalData = async (project) => {
                 if (!isExternalSelect(component)) {
                     return project.mcpResponse(template_1.ResponseTemplate.fetchExternalDataError, {
                         dataPath: data_path,
-                        error: `Component at "${data_path}" is of type "${component.type}" and does not load external data. This tool only supports select/selectboxes components with dataSrc "url" or "resource", and datasource components.`
+                        error: `Component at "${data_path}" is of type "${component.type}" and does not load external data. This tool only supports select, selectboxes and radio components with dataSrc "url" or "resource", and datasource components.`
                     }, true);
                 }
+                // isExternalSelect() has checked that dataSrc is "url" or "resource".
                 const selectComponent = component;
-                const dataSrc = selectComponent.dataSrc;
-                if (dataSrc !== 'url' && dataSrc !== 'resource') {
-                    return project.mcpResponse(template_1.ResponseTemplate.fetchExternalDataError, {
-                        dataPath: data_path,
-                        error: `Component at "${data_path}" has dataSrc "${dataSrc}". Only "url" and "resource" are supported by this tool.`
-                    }, true);
-                }
-                let items = [];
-                if (dataSrc === 'url') {
-                    items = await fetchUrlData(selectComponent, search_value, extra.authInfo, evalContext);
-                }
-                else if (dataSrc === 'resource') {
-                    items = await fetchResourceData(selectComponent, search_value, extra.authInfo, project, evalContext);
-                }
+                const items = selectComponent.dataSrc === 'url'
+                    ? await fetchUrlData(selectComponent, search_value, extra.authInfo, evalContext)
+                    : await fetchResourceData(selectComponent, search_value, extra.authInfo, project, evalContext);
                 const options = items.map(item => ({
                     label: extractLabel(item, selectComponent, evalContext),
                     value: extractValue(item, selectComponent)

package/lib/tools/findSubmission.js

@@ -7,8 +7,36 @@ const lodash_1 = require("lodash");
 const SchemaBuilder_1 = require("./SchemaBuilder");
 const annotations_1 = require("./annotations");
 const error = require('debug')('formio:uag:findSubmission:error');
+/** The query parameter suffix for each operator that compares the value as given. */
+const COMPARISON_SUFFIXES = new Map([
+    ['equals', ''],
+    ['greater_than', '__gt'],
+    ['greater_than_equal', '__gte'],
+    ['less_than', '__lt'],
+    ['less_than_equal', '__lte'],
+    ['not_equals', '__ne'],
+]);
+/** The query parameter suffix for each operator that takes comma-separated values. */
+const LIST_SUFFIXES = new Map([
+    ['in', '__in'],
+    ['nin', '__nin'],
+]);
+/** The `__regex` pattern for each operator that matches the value literally. */
+const LITERAL_PATTERNS = new Map([
+    ['contains', (value) => `/${(0, utils_1.escapeSearchPattern)(value)}/i`],
+    ['starts_with', (value) => `/^${(0, utils_1.escapeSearchPattern)(value)}/i`],
+    ['ends_with', (value) => `/${(0, utils_1.escapeSearchPattern)(value)}$/i`],
+]);
+/**
+ * A regex operator's pattern with every "/" in it, bare or escaped, written as
+ * the `\x2f` escape, which matches the same character. See escapeSearchPattern()
+ * for why the query parameter cannot carry a slash.
+ */
+const withoutSlashes = (pattern) => pattern.replace(/\\.|\//g, (match) => (match === '/' || match === '\\/') ? '\\x2f' : match);
+/** The last 4 characters of a submission's id, which users disambiguate with. */
+const partialIdOf = (submission) => submission._id ? submission._id.toString().slice(-4) : 'N/A';
 const findSubmission = async (project) => {
-    return (0, lodash_1.defaultsDeep)(project.config?.toolOverrides?.find_submissions || {}, {
+    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. To retrieve the total count of records within a form, use this tool without providing a `search_query`.',
@@ -36,6 +64,8 @@ const findSubmission = async (project) => {
                             error: 'Each search criterion must include both data_path and search_value'
                         }, true);
                     }
+                    let key;
+                    let value;
                     if (criterion.operator === 'regex') {
                         // The value is a pattern by request here, so it is passed through
                         // unescaped. It is still compiled first: the server drops a filter
@@ -51,42 +81,20 @@ const findSubmission = async (project) => {
                                 error: `"${criterion.search_value}" is not a valid regular expression for "${criterion.data_path}". Use the "contains" operator to search for it literally.`
                             }, true);
                         }
-                        query[`data.${criterion.data_path}__regex`] = `/${criterion.search_value}/i`;
+                        key = `data.${criterion.data_path}__regex`;
+                        value = `/${withoutSlashes(criterion.search_value)}/i`;
                     }
-                    else if (criterion.operator === 'equals') {
-                        query[`data.${criterion.data_path}`] = criterion.search_value;
+                    else if (LITERAL_PATTERNS.has(criterion.operator)) {
+                        key = `data.${criterion.data_path}__regex`;
+                        value = LITERAL_PATTERNS.get(criterion.operator)(criterion.search_value);
                     }
-                    else if (criterion.operator === 'contains') {
-                        query[`data.${criterion.data_path}__regex`] = `/${(0, utils_1.escapeSearchPattern)(criterion.search_value)}/i`;
+                    else if (COMPARISON_SUFFIXES.has(criterion.operator)) {
+                        key = `data.${criterion.data_path}${COMPARISON_SUFFIXES.get(criterion.operator)}`;
+                        value = criterion.search_value;
                     }
-                    else if (criterion.operator === 'starts_with') {
-                        query[`data.${criterion.data_path}__regex`] = `/^${(0, utils_1.escapeSearchPattern)(criterion.search_value)}/i`;
-                    }
-                    else if (criterion.operator === 'ends_with') {
-                        query[`data.${criterion.data_path}__regex`] = `/${(0, utils_1.escapeSearchPattern)(criterion.search_value)}$/i`;
-                    }
-                    else if (criterion.operator === 'greater_than') {
-                        query[`data.${criterion.data_path}__gt`] = criterion.search_value;
-                    }
-                    else if (criterion.operator === 'greater_than_equal') {
-                        query[`data.${criterion.data_path}__gte`] = criterion.search_value;
-                    }
-                    else if (criterion.operator === 'less_than') {
-                        query[`data.${criterion.data_path}__lt`] = criterion.search_value;
-                    }
-                    else if (criterion.operator === 'less_than_equal') {
-                        query[`data.${criterion.data_path}__lte`] = criterion.search_value;
-                    }
-                    else if (criterion.operator === 'not_equals') {
-                        query[`data.${criterion.data_path}__ne`] = criterion.search_value;
-                    }
-                    else if (criterion.operator === 'in') {
-                        const values = criterion.search_value.split(',').map((v) => v.trim());
-                        query[`data.${criterion.data_path}__in`] = values;
-                    }
-                    else if (criterion.operator === 'nin') {
-                        const values = criterion.search_value.split(',').map((v) => v.trim());
-                        query[`data.${criterion.data_path}__nin`] = values;
+                    else if (LIST_SUFFIXES.has(criterion.operator)) {
+                        key = `data.${criterion.data_path}${LIST_SUFFIXES.get(criterion.operator)}`;
+                        value = criterion.search_value.split(',').map((v) => v.trim());
                     }
                     else {
                         return project.mcpResponse(template_1.ResponseTemplate.submissionSearchError, {
@@ -95,6 +103,16 @@ const findSubmission = async (project) => {
                             error: `Unsupported operator "${criterion.operator}"`
                         }, true);
                     }
+                    // Criteria are ANDed, but each query parameter holds one value: a
+                    // second one would replace the first and widen the search.
+                    if (key in query) {
+                        return project.mcpResponse(template_1.ResponseTemplate.submissionSearchError, {
+                            form: form.form,
+                            searchQuery: search_query,
+                            error: `"${criterion.data_path}" has two criteria that cannot be combined (contains, starts_with, ends_with and regex count as one kind). Use a single "regex" criterion that matches both, or "in"/"nin" for several values.`
+                        }, true);
+                    }
+                    query[key] = value;
                 }
             }
             try {
@@ -129,7 +147,7 @@ const findSubmission = async (project) => {
                         formName: form_name
                     });
                 }
-                if (submission_id_partial && submissions.length > 1) {
+                if (submission_id_partial) {
                     const matchingSubmissions = submissions.filter(sub => sub._id && sub._id.toString().toLowerCase().includes(submission_id_partial.toLowerCase()));
                     if (matchingSubmissions.length === 0) {
                         return project.mcpResponse(template_1.ResponseTemplate.submissionPartialIdNotFound, {
@@ -138,7 +156,7 @@ const findSubmission = async (project) => {
                             partialId: submission_id_partial,
                             availableSubmissions: submissions.map(sub => ({
                                 ...form.formatSubmission(sub),
-                                partialId: sub._id ? sub._id.toString().slice(-4) : 'N/A'
+                                partialId: partialIdOf(sub)
                             }))
                         }, true);
                     }
@@ -150,35 +168,23 @@ const findSubmission = async (project) => {
                             matchingSubmissions: matchingSubmissions.map(sub => ({
                                 ...form.formatSubmission(sub),
                                 fullId: sub._id,
-                                partialId: sub._id ? sub._id.toString().slice(-4) : 'N/A'
+                                partialId: partialIdOf(sub)
                             }))
                         }, true);
                     }
                     submissions = matchingSubmissions;
                 }
-                function getFieldValues(submission) {
-                    if (!fields_requested || fields_requested.length === 0) {
-                        return [];
-                    }
-                    const data = [];
-                    for (const fieldPath of fields_requested) {
-                        data.push({ path: fieldPath, value: (0, lodash_1.get)(submission.data, fieldPath, null) });
-                    }
-                    return data;
-                }
                 return project.mcpResponse(template_1.ResponseTemplate.submissionsFound, {
                     form: form.form,
                     searchQuery: JSON.stringify(search_query),
                     submissionCount,
-                    submissions: submissions.map(sub => {
-                        return {
-                            _id: sub._id,
-                            created: sub.created,
-                            modified: sub.modified,
-                            data: getFieldValues(sub),
-                            partialId: sub._id ? sub._id.toString().slice(-4) : 'N/A'
-                        };
-                    })
+                    submissions: submissions.map(sub => ({
+                        _id: sub._id,
+                        created: sub.created,
+                        modified: sub.modified,
+                        data: (fields_requested || []).map((path) => ({ path, value: (0, lodash_1.get)(sub.data, path, null) })),
+                        partialId: partialIdOf(sub)
+                    }))
                 });
             }
             catch (err) {

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,10 @@ import { findSubmission } from "./findSubmission";
 import { submissionUpdate } from "./submissionUpdate";
 import { ToolInfo } from "./utils";
 import { UAGProjectInterface } from "../UAGProjectInterface";
+import { agentProvide, agentProvideData } from "./agentProvide";
+import { agentDecide } from "./agentDecide";
 import { fetchExternalData } from "./fetchExternalData";
 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, agentProvideData, agentDecide };
 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.agentDecide = exports.agentProvideData = 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; } });
+Object.defineProperty(exports, "agentProvideData", { enumerable: true, get: function () { return agentProvide_1.agentProvideData; } });
+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; } });
 __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),
+        // Deprecated: the earlier name of agent_provide.
+        (0, agentProvide_1.agentProvideData)(project),
+        (0, fetchExternalData_1.fetchExternalData)(project)
+    ]);
 };
 exports.getTools = getTools;

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.',

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formio/uag",
-  "version": "1.13.2",
+  "version": "2.0.0-rc.1",
   "mcpName": "io.form/formio-uag",
   "description": "The Form.io Universal Agent Gateway (UAG).",
   "main": "lib/index.js",
@@ -9,19 +9,30 @@
     "node": ">=22.0.0"
   },
   "files": [
-    "lib"
+    "lib",
+    "bin"
+  ],
+  "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",
+    "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: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 +41,21 @@
   "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.24.1",
+    "@formio/appserver-core": "^2.24.1",
+    "@formio/core": "2.9.0",
+    "@formio/uag-sdk": "^2.0.0-rc.1",
+    "@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",
+    "mongodb": "^7.7.0",
     "node-cache": "^5.1.2",
     "node-html-markdown": "^2.0.0",
-    "zod": "^4.4.3"
+    "zod": "^4.6.7"
   },
   "resolutions": {
     "tar": ">=7.5.12",
@@ -52,22 +66,27 @@
     "dompurify": ">=3.3.3"
   },
   "devDependencies": {
-    "@anthropic-ai/sdk": "^0.115.0",
+    "@anthropic-ai/sdk": "^1.3.0",
+    "@formio/js": "5.6.1",
     "@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",
     "@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.5",
     "@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.2",
+    "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 +97,9 @@
     "isolated-vm": {
       "built": true
     }
+  },
+  "bin": {
+    "uag": "bin/uag.js",
+    "uag-eval": "bin/uag-eval.js"
   }
 }

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>;