@formio/uag 1.3.0

package/lib/tools/SchemaBuilder.d.ts

@@ -0,0 +1,136 @@
+import z from "zod";
+import { UAGProjectInterface } from "../UAGProjectInterface";
+/**
+ * Schema builder for tool input schemas.
+ */
+export declare class SchemaBuilder {
+    private project;
+    schema: Record<string, z.ZodTypeAny>;
+    constructor(project: UAGProjectInterface);
+    get valueRules(): string;
+    /**
+     * Provide the form name.
+     */
+    form_name(): this;
+    /**
+     * The current form data being collected.
+     * This is a flat key/value pair object where the key is the `data_path` of the field and
+     * the value is the collected value for that field.
+     *
+     * ```json
+     * {
+     *   "firstName": "Joe",
+     *   "lastName": "Smith",
+     *   "company.name": "Acme Corp",
+     *   "company.address.street": "123 Main St",
+     *   "children[0].name": "Tom",
+     *   "children[0].age": 5,
+     *   "children[1].name": "Sally",
+     *   "children[1].age": 3
+     * }
+     * ```
+     */
+    form_data(): this;
+    /**
+     * An array of `data_path`s to get detailed information for specific fields.
+     * Each `data_path` within the array should correlate to the fields the user has provided values for.
+     *
+     * ```json
+     * [
+     *   "firstName",
+     *   "lastName",
+     *   "company.name",
+     *   "company.address.street",
+     *   "children[0].name",
+     *   "children[0].age",
+     *   "children[1].name",
+     *   "children[1].age"
+     * ]
+     * ```
+     */
+    field_paths(): this;
+    /**
+     * The field "criteria" which for the UAG is the "requiredness" of the field.
+     *
+     * ["all", "required", "optional"]
+     *
+     */
+    criteria(): this;
+    /**
+     * An array of search criteria to find matching submissions.
+     * All criteria must match (AND logic).
+     *
+     * ```json
+     * [
+     *  {
+     *     "data_path": "customer.email",
+     *     "operator": "equals",
+     *     "search_value": "<email>"
+     *  },
+     *  {
+     *     "data_path": "customer.name",
+     *     "operator": "equals",
+     *     "search_value": "<name>"
+     *  }
+     * ]
+     * ```
+     */
+    search_query(): this;
+    /**
+     * An array of "data_path"(s) for values you wish to include in the result.
+     * If not provided, only submission IDs and timestamps are returned.
+     *
+     * ```json
+     * [
+     *   "email",
+     *   "firstName",
+     *   "lastName"
+     * ]
+     */
+    fields_requested(): this;
+    /**
+     * The maximum number of results to return. Defaults to 5.
+     */
+    limit(): this;
+    /**
+     * The full ID of the submission to retrieve details for. This value is provided using the `find_submissions` tool.
+     */
+    submission_id(): this;
+    /**
+     * The last 4 characters of a specific submission ID.
+     * Should ONLY be used when multiple matches are found from a previous query
+     * and the user provides the last 4 characters of the Submission ID to disambiguate.
+     */
+    submission_id_partial(): this;
+    /**
+     * Optional parent component information if collecting data for a specific nested component within a form.
+     * If not provided, the tool assumes data is being collected for the root form.
+     *
+     * ```json
+     * {
+     *   "type": "datagrid",
+     *   "isTable": true,
+     *   "data_path": "children"
+     * }
+     * ```
+     */
+    parent(): this;
+    /**
+     * An array of field updates to apply to the `form_data`.
+     * Each update specifies the `data_path` and the complete new value.
+     *
+     * ```json
+     * [
+     *   {
+     *     "data_path": "firstName",
+     *     "new_value": "John"
+     *   },
+     *   {
+     *     "data_path": "lastName",
+     *     "new_value": "Doe"
+     *   }
+     * ]
+     * ```
+     */
+    updates(): this;
+}

package/lib/tools/SchemaBuilder.js

@@ -0,0 +1,192 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaBuilder = void 0;
+const zod_1 = __importDefault(require("zod"));
+/**
+ * Schema builder for tool input schemas.
+ */
+class SchemaBuilder {
+    constructor(project) {
+        this.project = project;
+        this.schema = {};
+    }
+    get valueRules() {
+        return 'The rules for the value is determined using the `get_form_fields` tool within the **Field Rules** section for this component type, and formatted according the the **Format** section of that component (if applicable). If a value already exists, and it is a string, then you can append/prepend to it to the existing value in the proper order (append/prepend) determined by the user response. If the value is not a string, then replace the value entirely.';
+    }
+    /**
+     * Provide the form name.
+     */
+    form_name() {
+        this.schema.form_name = zod_1.default.enum((this.project?.formNames || [])).describe('The name of the form being filled out');
+        return this;
+    }
+    /**
+     * The current form data being collected.
+     * This is a flat key/value pair object where the key is the `data_path` of the field and
+     * the value is the collected value for that field.
+     *
+     * ```json
+     * {
+     *   "firstName": "Joe",
+     *   "lastName": "Smith",
+     *   "company.name": "Acme Corp",
+     *   "company.address.street": "123 Main St",
+     *   "children[0].name": "Tom",
+     *   "children[0].age": 5,
+     *   "children[1].name": "Sally",
+     *   "children[1].age": 3
+     * }
+     * ```
+     */
+    form_data() {
+        this.schema.form_data = zod_1.default.record(zod_1.default.string().describe('The `data_path` of collected field.'), zod_1.default.any().describe(`The value collected for the field. ${this.valueRules}`)).optional().default({}).describe('The current data collected so far for the whole form without any updates applied. Include ALL previously collected field data to maintain session state.');
+        return this;
+    }
+    /**
+     * An array of `data_path`s to get detailed information for specific fields.
+     * Each `data_path` within the array should correlate to the fields the user has provided values for.
+     *
+     * ```json
+     * [
+     *   "firstName",
+     *   "lastName",
+     *   "company.name",
+     *   "company.address.street",
+     *   "children[0].name",
+     *   "children[0].age",
+     *   "children[1].name",
+     *   "children[1].age"
+     * ]
+     * ```
+     */
+    field_paths() {
+        this.schema.field_paths = zod_1.default.array(zod_1.default.string()).describe('An array of `data_path`s to get detailed information for specific fields. Each `data_path` within the array should correlate to the fields the user has provided values for. The `data_path`s can be found using the `get_form_fields` tool.');
+        return this;
+    }
+    /**
+     * The field "criteria" which for the UAG is the "requiredness" of the field.
+     *
+     * ["all", "required", "optional"]
+     *
+     */
+    criteria() {
+        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;
+    }
+    /**
+     * An array of search criteria to find matching submissions.
+     * All criteria must match (AND logic).
+     *
+     * ```json
+     * [
+     *  {
+     *     "data_path": "customer.email",
+     *     "operator": "equals",
+     *     "search_value": "<email>"
+     *  },
+     *  {
+     *     "data_path": "customer.name",
+     *     "operator": "equals",
+     *     "search_value": "<name>"
+     *  }
+     * ]
+     * ```
+     */
+    search_query() {
+        this.schema.search_query = zod_1.default.array(zod_1.default.object({
+            data_path: zod_1.default.string().describe('The data path of the field used to search (e.g., "email", "customer.firstName", or "parent.email")'),
+            operator: zod_1.default.enum(['equals', 'not_equals', 'contains', 'starts_with', 'ends_with', 'regex', 'in', 'nin', 'greater_than', 'greater_than_equal', 'less_than', '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). Use `get_form_fields` to get `data_path`s.');
+        return this;
+    }
+    /**
+     * An array of "data_path"(s) for values you wish to include in the result.
+     * If not provided, only submission IDs and timestamps are returned.
+     *
+     * ```json
+     * [
+     *   "email",
+     *   "firstName",
+     *   "lastName"
+     * ]
+     */
+    fields_requested() {
+        this.schema.fields_requested = zod_1.default.array(zod_1.default.string()).optional().describe('An array of "data_path"(s) for values you wish to include in the result. If not provided, only submission IDs and timestamps are returned. Use `get_form_fields` to get valid `data_path`s. (e.g., ["email"] - "What is the email address for the employee Joe Smith?")');
+        return this;
+    }
+    /**
+     * The maximum number of results to return. Defaults to 5.
+     */
+    limit() {
+        this.schema.limit = zod_1.default.number().optional().default(5).describe('The maximum number of results to return. Defaults to 5.');
+        return this;
+    }
+    /**
+     * The full ID of the submission to retrieve details for. This value is provided using the `find_submissions` tool.
+     */
+    submission_id() {
+        this.schema.submission_id = zod_1.default.string().optional().describe('The full ID of the submission to retrieve details for. This value is provided using the `find_submissions` tool.');
+        return this;
+    }
+    /**
+     * The last 4 characters of a specific submission ID.
+     * Should ONLY be used when multiple matches are found from a previous query
+     * and the user provides the last 4 characters of the Submission ID to disambiguate.
+     */
+    submission_id_partial() {
+        this.schema.submission_id_partial = zod_1.default.string().optional().describe('Last 4 characters of a specific submission ID. Should ONLY be used when multiple matches are found from a previous query and the user provides the last 4 characters of the Submission ID to disambiguate.');
+        return this;
+    }
+    /**
+     * Optional parent component information if collecting data for a specific nested component within a form.
+     * If not provided, the tool assumes data is being collected for the root form.
+     *
+     * ```json
+     * {
+     *   "type": "datagrid",
+     *   "isTable": true,
+     *   "data_path": "children"
+     * }
+     * ```
+     */
+    parent() {
+        this.schema.parent = zod_1.default.object({
+            type: zod_1.default.string().describe('The type of the parent component that contains nested components to collect data for. To find the type, you can use the `get_form_fields` tool for this path and look at the **Type** of that field.'),
+            label: zod_1.default.string().optional().describe('The label of the parent component that contains nested components to collect data for. This comes from the **Label** property of the field provided by the `get_form_fields` tool.'),
+            isTable: zod_1.default.boolean().optional().describe('Indicates if the parent component is a table-like component (datagrid or editgrid). This means that the value of this component is an array of objects, where each row is a new context of data for the fields within. Set this value to `true` if the `get_form_fields` tool says to use `parent.isTable=true`.'),
+            isForm: zod_1.default.boolean().optional().describe('Indicates if the parent component is a nested form-like component. This means that the value of this component is in the format of `{data: {...}}` where `{...}` is the context of data for the fields within. Set this value to `true` if the `get_form_fields` tool says to use `parent.isForm=true`.'),
+            isContainer: zod_1.default.boolean().optional().describe('Indicates if the parent component is a container-like component. This means that the value of this component is in the format of `{...}` where `{...}` is the context of data for the fields within. Set this value to `true` if the `get_form_fields` tool says to use `parent.isContainer=true`.'),
+            data_path: zod_1.default.string().describe('The `data_path` of the parent component that contains nested components to collect data for. To find the data_path, you can use the `get_form_fields` tool.')
+        }).optional().describe('Optional parent component information if collecting data for a specific nested component within a form. If not provided, the tool assumes data is being collected for the root form.');
+        return this;
+    }
+    /**
+     * An array of field updates to apply to the `form_data`.
+     * Each update specifies the `data_path` and the complete new value.
+     *
+     * ```json
+     * [
+     *   {
+     *     "data_path": "firstName",
+     *     "new_value": "John"
+     *   },
+     *   {
+     *     "data_path": "lastName",
+     *     "new_value": "Doe"
+     *   }
+     * ]
+     * ```
+     */
+    updates() {
+        this.schema.updates = zod_1.default.array(zod_1.default.object({
+            data_path: zod_1.default.string().describe('The `data_path` of the field to update. To find the data_path, you can use the `get_form_fields` tool.'),
+            new_value: zod_1.default.any().describe(`The complete new value for the field. ${this.valueRules}`)
+        }).describe('A single field update including the `data_path` and new value.')).describe('An array of field updates to apply to the `form_data`. Each update specifies the `data_path` and the complete new value.');
+        return this;
+    }
+}
+exports.SchemaBuilder = SchemaBuilder;

package/lib/tools/collectData.d.ts

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

package/lib/tools/collectData.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectData = void 0;
+const template_1 = require("../template");
+const utils_1 = require("./utils");
+const lodash_1 = require("lodash");
+const SchemaBuilder_1 = require("./SchemaBuilder");
+const lodash_2 = require("lodash");
+const collectData = async (project) => {
+    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.',
+        inputSchema: (new SchemaBuilder_1.SchemaBuilder(project))
+            .form_name()
+            .form_data()
+            .parent()
+            .updates().schema,
+        execute: async ({ form_name, form_data, parent, updates }, extra) => {
+            const form = await project.getForm(form_name);
+            if (!form) {
+                return project.mcpResponse(template_1.ResponseTemplate.formNotFound, { formName: form_name }, true);
+            }
+            // Ensure the parent is undefined if the type or data_path is missing.
+            if (!parent?.data_path || !parent.type) {
+                parent = undefined;
+            }
+            // Merge the updates into the current data.
+            for (const { data_path, new_value } of updates) {
+                form_data[data_path] = new_value;
+            }
+            // Get any form errors.
+            const submission = form.convertToSubmission(form_data);
+            // 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) {
+                return project.mcpResponse(template_1.ResponseTemplate.fieldValidationErrors, { invalidFields: fields.errors });
+            }
+            const collectedData = parent ? (0, lodash_2.get)(submission, parent.data_path || '') : submission.data;
+            // 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, {
+                    form: form.form,
+                    parent,
+                    parentDataPath: (0, utils_1.getParentDataPath)(parent, fields.rowIndex),
+                    parentLabel: (0, utils_1.getParentLabel)(parent),
+                    rowIndex: fields.rowIndex,
+                    dataSummary: project.uagTemplate?.renderTemplate(template_1.ResponseTemplate.collectedData, {
+                        data: form.formatData(collectedData)
+                    })
+                });
+            }
+            // Collect more required fields.
+            return project.mcpResponse(template_1.ResponseTemplate.fieldCollectedNext, {
+                parent,
+                parentDataPath: (0, utils_1.getParentDataPath)(parent, fields.rowIndex),
+                parentLabel: (0, utils_1.getParentLabel)(parent, form.form),
+                message: 'Form data collected successfully!',
+                rules: project.uagTemplate?.renderTemplate(template_1.ResponseTemplate.fieldRules, { rules: Object.entries(fields.required.rules) }),
+                fields: project.uagTemplate?.renderTemplate(template_1.ResponseTemplate.fields, { fields: fields.required.components }),
+                dataSummary: project.uagTemplate?.renderTemplate(template_1.ResponseTemplate.collectedData, {
+                    data: form.formatData(collectedData)
+                }),
+                progress: {
+                    collected: Object.keys(form_data).length,
+                    total: fields.required.components.length + Object.keys(form_data).length
+                }
+            });
+        }
+    });
+};
+exports.collectData = collectData;

package/lib/tools/confirmSubmission.d.ts

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

package/lib/tools/confirmSubmission.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmSubmission = void 0;
+const template_1 = require("../template");
+const utils_1 = require("./utils");
+const lodash_1 = require("lodash");
+const SchemaBuilder_1 = require("./SchemaBuilder");
+const confirmSubmission = async (project) => {
+    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 and ask the user for confirmation before submitting',
+        inputSchema: (new SchemaBuilder_1.SchemaBuilder(project))
+            .form_name()
+            .form_data().schema,
+        execute: async ({ form_name, form_data }, extra) => {
+            const form = await project.getForm(form_name);
+            if (!form) {
+                return project.mcpResponse(template_1.ResponseTemplate.formNotFound, { formName: form_name }, true);
+            }
+            // Perform a validation check.
+            const submission = form.convertToSubmission(form_data);
+            // See which fields need to be filled out.
+            const fields = await form.getFields(submission, extra.authInfo);
+            if (fields.errors.length > 0) {
+                return project.mcpResponse(template_1.ResponseTemplate.fieldValidationErrors, { invalidFields: fields.errors });
+            }
+            // See if there are still required fields to fill out...
+            if (fields.required.components.length) {
+                return project.mcpResponse(template_1.ResponseTemplate.fieldCollectedNext, {
+                    parent: undefined,
+                    parentLabel: (0, utils_1.getParentLabel)(undefined, form.form),
+                    message: 'There is additional data that needs to be collected before submission.',
+                    rules: project.uagTemplate?.renderTemplate(template_1.ResponseTemplate.fieldRules, { rules: Object.entries(fields.required.rules) }),
+                    fields: project.uagTemplate?.renderTemplate(template_1.ResponseTemplate.fields, { fields: fields.required.components }),
+                    dataSummary: project.uagTemplate?.renderTemplate(template_1.ResponseTemplate.collectedData, {
+                        data: form.formatData(submission.data)
+                    }),
+                    progress: {
+                        collected: Object.keys(form_data).length,
+                        total: fields.required.components.length + Object.keys(form_data).length
+                    }
+                });
+            }
+            // Confirm the submission.
+            return project.mcpResponse(template_1.ResponseTemplate.confirmFormSubmission, {
+                form,
+                dataSummary: project.uagTemplate?.renderTemplate(template_1.ResponseTemplate.collectedData, {
+                    data: form.formatData(submission.data)
+                }),
+                currentData: form_data
+            });
+        }
+    });
+};
+exports.confirmSubmission = confirmSubmission;

package/lib/tools/findSubmission.d.ts

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

package/lib/tools/findSubmission.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findSubmission = void 0;
+const template_1 = require("../template");
+const lodash_1 = require("lodash");
+const SchemaBuilder_1 = require("./SchemaBuilder");
+const error = require('debug')('formio:uag:findSubmission:error');
+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.',
+        inputSchema: (new SchemaBuilder_1.SchemaBuilder(project))
+            .form_name()
+            .search_query()
+            .fields_requested()
+            .limit()
+            .submission_id()
+            .submission_id_partial().schema,
+        execute: async ({ form_name, search_query, fields_requested, limit, submission_id, submission_id_partial }, extra) => {
+            const form = await project.getForm(form_name);
+            if (!form) {
+                return project.mcpResponse(template_1.ResponseTemplate.formNotFound, { formName: form_name }, true);
+            }
+            const query = {};
+            if (!submission_id) {
+                for (const criterion of search_query) {
+                    if (!criterion.data_path || !criterion.search_value) {
+                        return project.mcpResponse(template_1.ResponseTemplate.submissionSearchError, {
+                            form: form.form,
+                            searchQuery: search_query,
+                            error: 'Each search criterion must include both data_path and search_value'
+                        }, true);
+                    }
+                    if (criterion.operator === 'regex') {
+                        query[`data.${criterion.data_path}__regex`] = `/${criterion.search_value}/i`;
+                    }
+                    else if (criterion.operator === 'equals') {
+                        query[`data.${criterion.data_path}`] = criterion.search_value;
+                    }
+                    else if (criterion.operator === 'contains') {
+                        query[`data.${criterion.data_path}__regex`] = `/${criterion.search_value}/i`;
+                    }
+                    else if (criterion.operator === 'starts_with') {
+                        query[`data.${criterion.data_path}__regex`] = `/^${criterion.search_value}/i`;
+                    }
+                    else if (criterion.operator === 'ends_with') {
+                        query[`data.${criterion.data_path}__regex`] = `/${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 {
+                        return project.mcpResponse(template_1.ResponseTemplate.submissionSearchError, {
+                            form: form.form,
+                            searchQuery: search_query,
+                            error: `Unsupported operator "${criterion.operator}"`
+                        }, true);
+                    }
+                }
+            }
+            try {
+                let submissions = [];
+                if (submission_id) {
+                    const result = await form.loadSubmission(submission_id, extra.authInfo);
+                    if (result) {
+                        submissions = [result];
+                    }
+                }
+                else {
+                    query.limit = ((0, lodash_1.isNumber)(limit) && limit > 0) ? limit : 10;
+                    const result = await form.find(query, extra.authInfo);
+                    submissions = result.items;
+                }
+                if (!submissions || submissions.length === 0) {
+                    return project.mcpResponse(template_1.ResponseTemplate.noSubmissionsFound, {
+                        form: form.form,
+                        searchQuery: search_query,
+                        formName: form_name
+                    });
+                }
+                if (submission_id_partial && submissions.length > 1) {
+                    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, {
+                            form: form.form,
+                            searchQuery: search_query,
+                            partialId: submission_id_partial,
+                            availableSubmissions: submissions.map(sub => ({
+                                ...form.formatSubmission(sub),
+                                partialId: sub._id ? sub._id.toString().slice(-4) : 'N/A'
+                            }))
+                        }, true);
+                    }
+                    if (matchingSubmissions.length > 1) {
+                        return project.mcpResponse(template_1.ResponseTemplate.submissionPartialIdAmbiguous, {
+                            form: form.form,
+                            searchQuery: search_query,
+                            partialId: submission_id_partial,
+                            matchingSubmissions: matchingSubmissions.map(sub => ({
+                                ...form.formatSubmission(sub),
+                                fullId: sub._id,
+                                partialId: sub._id ? sub._id.toString().slice(-4) : 'N/A'
+                            }))
+                        }, 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),
+                    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'
+                        };
+                    }),
+                    resultCount: submissions.length
+                });
+            }
+            catch (err) {
+                error('Error searching submissions:', err);
+                return project.mcpResponse(template_1.ResponseTemplate.submissionSearchError, {
+                    form: form.form,
+                    searchQuery: JSON.stringify(search_query),
+                    error: err instanceof Error ? err.message : 'Unknown error'
+                }, true);
+            }
+        }
+    });
+};
+exports.findSubmission = findSubmission;

package/lib/tools/getFieldInfo.d.ts

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