@esheet/builder 0.0.4-0 → 0.0.4-2

package/dist/lib/icons.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Builder icon components — ported from questionnaire-builder (old QB).
+ *
+ * All icons accept a `className` prop and render inline SVGs using `currentColor`.
+ * Usage: <TrashIcon className="ms:w-5 ms:h-5 ms:text-mstextmuted" />
+ */
+import React from 'react';
+const eq = (a, b) => a.className === b.className;
+// ---------------------------------------------------------------------------
+// Shared icons — re-exported from @esheet/fields
+// ---------------------------------------------------------------------------
+export { TrashIcon, PlusIcon, ArrowUpIcon, ArrowDownIcon, UpDownArrowIcon, } from '@esheet/fields';
+// ---------------------------------------------------------------------------
+// Field Wrapper actions
+// ---------------------------------------------------------------------------
+export const ViewBigIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { stroke: "none", d: "M0 0h24v24H0z", fill: "none" }), _jsx("path", { d: "M12 10v-7l3 3" }), _jsx("path", { d: "M9 6l3 -3" }), _jsx("path", { d: "M12 14v7l3 -3" }), _jsx("path", { d: "M9 18l3 3" }), _jsx("path", { d: "M18 3h1a2 2 0 0 1 2 2v14a2 2 0 0 1 -2 2h-1" }), _jsx("path", { d: "M6 3h-1a2 2 0 0 0 -2 2v14a2 2 0 0 0 2 2h1" })] })), eq);
+export const ViewSmallIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { stroke: "none", d: "M0 0h24v24H0z", fill: "none" }), _jsx("path", { d: "M12 3v7l3 -3" }), _jsx("path", { d: "M9 7l3 3" }), _jsx("path", { d: "M12 21v-7l3 3" }), _jsx("path", { d: "M9 17l3 -3" }), _jsx("path", { d: "M18 9h1a2 2 0 0 1 2 2v2a2 2 0 0 1 -2 2h-1" }), _jsx("path", { d: "M6 9h-1a2 2 0 0 0 -2 2v2a2 2 0 0 0 2 2h1" })] })), eq);
+export const EditIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M7 7H6a2 2 0 0 0-2 2v9a2 2 0 0 0 2 2h9a2 2 0 0 0 2-2v-1" }), _jsx("path", { d: "M20.385 6.585a2.1 2.1 0 0 0-2.97-2.97L9 12v3h3zM16 5l3 3" })] })), eq);
+// ---------------------------------------------------------------------------
+// ToolPanel category icons
+// ---------------------------------------------------------------------------
+export const TextFieldsIcon = React.memo(({ className = '' }) => (_jsx("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M4 8V6a2 2 0 0 1 2-2h2M4 16v2a2 2 0 0 0 2 2h2m8-16h2a2 2 0 0 1 2 2v2m-4 12h2a2 2 0 0 0 2-2v-2m-8 0V9M9 9h6" }) })), eq);
+export const SelectionFieldsIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M3 5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z" }), _jsx("path", { d: "m9 11l3 3l3-3" })] })), eq);
+export const RatingIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M11 6h9" }), _jsx("path", { d: "M11 12h9" }), _jsx("path", { d: "M12 18h8" }), _jsx("path", { d: "M4 16a2 2 0 1 1 4 0c0 0.591 -0.5 1 -1 1.5L4 20h4" }), _jsx("path", { d: "M6 10V4L4 6" })] })), eq);
+export const MatrixIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M4 5a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" }), _jsx("path", { d: "M11 5a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" }), _jsx("path", { d: "M18 5a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" }), _jsx("path", { d: "M4 12a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" }), _jsx("path", { d: "M11 12a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" }), _jsx("path", { d: "M18 12a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" }), _jsx("path", { d: "M4 19a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" }), _jsx("path", { d: "M11 19a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" }), _jsx("path", { d: "M18 19a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" })] })), eq);
+export const RichContentIcon = React.memo(({ className = '' }) => (_jsx("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "m15 7 -6.5 6.5a1.5 1.5 0 0 0 3 3L18 10a3 3 0 0 0 -6 -6l-6.5 6.5a4.5 4.5 0 0 0 9 9L21 13" }) })), eq);
+export const OrganizationIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M9 4h3l2 2h5a2 2 0 0 1 2 2v7a2 2 0 0 1 -2 2H9a2 2 0 0 1 -2 -2V6a2 2 0 0 1 2 -2" }), _jsx("path", { d: "M17 17v2a2 2 0 0 1 -2 2H5a2 2 0 0 1 -2 -2v-9a2 2 0 0 1 2 -2h2" })] })), eq);
+// ---------------------------------------------------------------------------
+// BuilderHeader — mode toggle icons
+// ---------------------------------------------------------------------------
+export const VEditorIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "2", children: [_jsx("path", { d: "M4 20h4L18.5 9.5a2.828 2.828 0 1 0 -4 -4L4 16v4" }), _jsx("path", { d: "m13.5 6.5 4 4" }), _jsx("path", { d: "m19 16 -2 3h4l-2 3" })] })), eq);
+export const PreviewIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "2", children: [_jsx("path", { d: "M15 8h0.01" }), _jsx("path", { d: "M3 6a3 3 0 0 1 3 -3h12a3 3 0 0 1 3 3v12a3 3 0 0 1 -3 3H6a3 3 0 0 1 -3 -3V6z" }), _jsx("path", { d: "m3 16 5 -5c0.928 -0.893 2.072 -0.893 3 0l5 5" }), _jsx("path", { d: "m14 14 1 -1c0.928 -0.893 2.072 -0.893 3 0l3 3" })] })), eq);
+// ---------------------------------------------------------------------------
+// BuilderHeader — action icons
+// ---------------------------------------------------------------------------
+export const UploadIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { stroke: "none", d: "M0 0h24v24H0z", fill: "none" }), _jsx("path", { d: "M4 17v2a2 2 0 0 0 2 2h12a2 2 0 0 0 2 -2v-2" }), _jsx("path", { d: "M7 9l5 -5l5 5" }), _jsx("path", { d: "M12 4l0 12" })] })), eq);
+export const DownloadIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { stroke: "none", d: "M0 0h24v24H0z", fill: "none" }), _jsx("path", { d: "M4 17v2a2 2 0 0 0 2 2h12a2 2 0 0 0 2 -2v-2" }), _jsx("path", { d: "M7 11l5 5l5 -5" }), _jsx("path", { d: "M12 4l0 12" })] })), eq);
+export const CodeIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "m7 8 -4 4 4 4" }), _jsx("path", { d: "m17 8 4 4 -4 4" }), _jsx("path", { d: "m14 4 -4 16" })] })), eq);
+// ---------------------------------------------------------------------------
+// Misc / shared
+// ---------------------------------------------------------------------------
+export const ChevronIcon = React.memo(({ className = '' }) => (_jsx("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M6 9l6 6l6 -6" }) })), eq);
+export const XIcon = React.memo(({ className = '' }) => (_jsx("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M18 6L6 18M6 6l12 12" }) })), eq);
+export const CheckIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { stroke: "none", d: "M0 0h24v24H0z", fill: "none" }), _jsx("path", { d: "M5 12l5 5l10 -10" })] })), eq);
+export const DragHandleIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "currentColor", children: [_jsx("path", { stroke: "none", d: "M0 0h24v24H0z", fill: "none" }), _jsx("circle", { cx: "9", cy: "5", r: "1" }), _jsx("circle", { cx: "9", cy: "12", r: "1" }), _jsx("circle", { cx: "9", cy: "19", r: "1" }), _jsx("circle", { cx: "15", cy: "5", r: "1" }), _jsx("circle", { cx: "15", cy: "12", r: "1" }), _jsx("circle", { cx: "15", cy: "19", r: "1" })] })), eq);
+export const LogicIcon = React.memo(({ className = '' }) => (_jsxs("svg", { className: className, xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "24", height: "24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { stroke: "none", d: "M0 0h24v24H0z", fill: "none" }), _jsx("path", { d: "M22 12h-5" }), _jsx("path", { d: "M2 9h5" }), _jsx("path", { d: "M2 15h5" }), _jsx("path", { d: "M9 5c6 0 8 3.5 8 7s-2 7 -8 7h-2v-14h2" })] })), eq);

package/dist/lib/mcp/index.js

@@ -0,0 +1,4 @@
+export { executeToolCall } from './tool-executor.js';
+export { BUILDER_TOOL_DEFINITIONS } from './tool-definitions.js';
+export { BUILDER_SYSTEM_PROMPT } from './system-prompt.js';
+export { useBuilderMcpToolHandler } from './useBuilderToolBridge.js';

package/dist/lib/mcp/system-prompt.js

@@ -0,0 +1,9 @@
+export const BUILDER_SYSTEM_PROMPT = 'Form builder assistant. Field types: text, longtext, multitext, radio, check, boolean, dropdown, multiselectdropdown, rating, ranking, slider, singlematrix, multimatrix, image, html, signature, diagram, display, section. ' +
+    'STRICT WORKFLOW: Before editing options/rows/columns on any field, call get_form_summary first to confirm the fieldType. ' +
+    'singlematrix and multimatrix fields are created empty (no default rows or columns) — after creating one, use add_row/add_column to populate it. Use update_row/remove_row for rows and update_column/remove_column for columns — NEVER use add_option on matrix fields. ' +
+    'add_option is ONLY for: radio, check, boolean, dropdown, multiselectdropdown, rating, ranking, slider, multitext. ' +
+    'IMPORTANT: When building a new form or questionnaire from scratch, ALWAYS call reset_form first to clear placeholder fields before adding new ones. ' +
+    'When using sections: first create the section field, then pass its ID as parentId on each subsequent create_field call to place fields inside it. ' +
+    'PREVIEW FILL WORKFLOW: When asked to fill the preview form, call fill_field for each field. Each response includes filledCount and unfilledFields (only fields still needing values). You are done when unfilledFields is empty. Never skip a field; generate realistic mock values for all fields including dates and times. ' +
+    'TEXT FIELD FORMATS: each field includes a valueFormat property — use it exactly (YYYY-MM-DD for date, YYYY-MM-DDTHH:mm for datetime-local, YYYY-MM for month, HH:mm for time). Wrong formats are rejected. ' +
+    'For conversational questions reply in plain text without calling a tool.';

package/dist/lib/mcp/tool-definitions.js

@@ -0,0 +1,436 @@
+export const BUILDER_TOOL_DEFINITIONS = [
+    {
+        type: 'function',
+        function: {
+            name: 'get_form_summary',
+            description: 'CALL THIS FIRST. Returns {formId, fieldCount, fields} where each field has: id, fieldType, question, required, optionCount, rowCount, columnCount, editWith, hasRules, hasValue. Use get_field for full option/row/column values when needed.',
+            parameters: { type: 'object', properties: {} },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'fill_field',
+            description: 'Set a preview response for ONE field. Returns { result, filledCount, unfilledFields } where unfilledFields contains ONLY the fields still needing values (with full details). You are done when unfilledFields is empty.\n\nField type rules:\n- radio/dropdown/boolean/rating/slider: single string matching an option value\n- check/multiselectdropdown: array of strings matching option values\n- ranking: ordered array of option value strings\n- multitext: array of strings, one per option slot\n- singlematrix: { "Row Label": "Column Label" } — call once per row, calls accumulate\n- multimatrix: { "Row Label": ["Col1", "Col2"] }\n- text: use the valueFormat from the field schema (YYYY-MM-DD for date, YYYY-MM-DDTHH:mm for datetime-local, YYYY-MM for month, HH:mm for time). Wrong formats are rejected with an error.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    value: {},
+                },
+                required: ['value'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'clear_responses',
+            description: 'Clear all responses.',
+            parameters: { type: 'object', properties: {} },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'get_responses',
+            description: 'Get current response values.',
+            parameters: { type: 'object', properties: {} },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'reset_form',
+            description: 'Clear all fields.',
+            parameters: { type: 'object', properties: {} },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'create_field',
+            description: 'Add one field. fieldType: text|longtext|radio|check|boolean|dropdown|multiselectdropdown|rating|ranking|slider|section|html|display|image|signature|diagram. properties: {inputType,unit,min,max,step}. Pass parentId to place the field directly inside a section. For "html" fields: set properties.htmlContent to a raw HTML string (e.g. "<p>Your message</p>") — do NOT use "question". For "display" fields: set properties.content to a markdown/formula string that may embed field values using {fieldId} syntax (e.g. "Your score is **{score-field}**") — do NOT use "question". For "section" fields: use properties.title instead of question.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldType: { type: 'string' },
+                    question: { type: 'string' },
+                    required: { type: 'boolean' },
+                    options: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: { value: { type: 'string' } },
+                            required: ['value'],
+                        },
+                    },
+                    afterFieldId: { type: 'string' },
+                    parentId: {
+                        type: 'string',
+                        description: 'ID of a section field to place this field inside.',
+                    },
+                    properties: { type: 'object', additionalProperties: true },
+                },
+                required: ['fieldType', 'question'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'update_field',
+            description: 'Change scalar field properties (question, required, inputType, min, max, step, placeholder). Do NOT pass rows or columns here — use add_row/add_column instead. Identify by fieldQuestion or fieldId.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    updates: { type: 'object', additionalProperties: true },
+                },
+                required: ['updates'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'delete_field',
+            description: 'Delete a field by fieldQuestion or fieldId.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                },
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'add_option',
+            description: 'Add an option to a radio, check, boolean, dropdown, multiselectdropdown, rating, ranking, slider, or multitext field. NOT for singlematrix/multimatrix — those use add_column or add_row. If you are unsure of the field type, call get_form_summary first.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    value: { type: 'string' },
+                },
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'update_option',
+            description: 'Update the label of an existing option on radio, check, dropdown, etc. NOT for singlematrix/multimatrix — use update_column or update_row instead. If you are unsure of the field type, call get_form_summary first. Use optionId from get_field, or currentValue to match by current label.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    optionId: { type: 'string' },
+                    currentValue: {
+                        type: 'string',
+                        description: 'Current label to match if optionId unknown',
+                    },
+                    value: { type: 'string' },
+                },
+                required: ['value'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'remove_option',
+            description: 'Remove an option from a radio, check, dropdown, etc. by its ID or current label. NOT for singlematrix/multimatrix — use remove_column or remove_row instead. If you are unsure of the field type, call get_form_summary first.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    optionId: { type: 'string' },
+                    currentValue: {
+                        type: 'string',
+                        description: 'Current label to match if optionId unknown',
+                    },
+                },
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'get_field',
+            description: 'Get full details of one field including its options/rows/columns with their IDs.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                },
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'move_field',
+            description: 'Reorder a field to a new index position (0-based). Use get_form_summary to see current order.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    toIndex: { type: 'number', description: '0-based target position' },
+                    toParentId: {
+                        type: 'string',
+                        description: 'Parent section ID, or omit for root',
+                    },
+                },
+                required: ['toIndex'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'add_row',
+            description: 'Add a row to a matrix field (singlematrix/multimatrix).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    value: { type: 'string' },
+                },
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'update_row',
+            description: 'Update a matrix row label. Use rowId from get_field, or currentValue to match by current label.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    rowId: { type: 'string' },
+                    currentValue: {
+                        type: 'string',
+                        description: 'Current label to match if rowId unknown',
+                    },
+                    value: { type: 'string' },
+                },
+                required: ['value'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'remove_row',
+            description: 'Remove a matrix row by its ID.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    rowId: { type: 'string' },
+                },
+                required: ['rowId'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'add_column',
+            description: 'Add a column to a matrix field.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    value: { type: 'string' },
+                },
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'update_column',
+            description: 'Update a matrix column label. Use columnId from get_field, or currentValue to match by current label.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    columnId: { type: 'string' },
+                    currentValue: {
+                        type: 'string',
+                        description: 'Current label to match if columnId unknown',
+                    },
+                    value: { type: 'string' },
+                },
+                required: ['value'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'remove_column',
+            description: 'Remove a matrix column by its ID.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    columnId: { type: 'string' },
+                },
+                required: ['columnId'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'get_field_types',
+            description: 'List all available field types with their key, label, category, and whether they support options or matrix rows/columns. Call this before create_field if unsure which fieldType to use.',
+            parameters: { type: 'object', properties: {} },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'get_field_spec',
+            description: 'Get the full spec for a specific field type: capabilities, default properties, and placeholder hints.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldType: {
+                        type: 'string',
+                        description: 'The field type key, e.g. "radio", "slider", "singlematrix"',
+                    },
+                },
+                required: ['fieldType'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'get_definition',
+            description: 'Export the complete current form as a JSON definition tree — all fields, options, rows, columns, and logic rules. Use this to inspect the full form structure or to verify logic rules on any field.',
+            parameters: { type: 'object', properties: {} },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'set_form_id',
+            description: 'Update the top-level form ID without replacing or modifying any fields.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'The new form ID.' },
+                },
+                required: ['id'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'add_field_rule',
+            description: 'Add a conditional logic rule to a field based on another field\'s response. Controls whether this field is visible, enabled, or required. effect: "visible"|"enable"|"required". logic: "AND"|"OR". Each condition: { targetId, operator, expected }. For option-based fields (radio, check, dropdown, etc.), expected must be the option ID (e.g. "o1") — use get_field to look up IDs. Operators: equals|notEquals|contains|includes|empty|notEmpty|greaterThan|greaterThanOrEqual|lessThan|lessThanOrEqual. Use "includes" for multi-select fields (check, multiselectdropdown, ranking). Use "empty"/"notEmpty" with no expected value.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    effect: {
+                        type: 'string',
+                        enum: ['visible', 'enable', 'required'],
+                    },
+                    logic: {
+                        type: 'string',
+                        enum: ['AND', 'OR'],
+                    },
+                    conditions: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                targetId: {
+                                    type: 'string',
+                                    description: 'Field ID whose response is checked.',
+                                },
+                                operator: {
+                                    type: 'string',
+                                    description: 'equals|notEquals|contains|includes|empty|notEmpty|greaterThan|greaterThanOrEqual|lessThan|lessThanOrEqual',
+                                },
+                                expected: {
+                                    type: 'string',
+                                    description: 'For option-based fields use the option ID (e.g. "o1"), not the label. Omit for empty/notEmpty.',
+                                },
+                            },
+                            required: ['targetId', 'operator'],
+                        },
+                    },
+                },
+                required: ['effect', 'logic', 'conditions'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'add_expression_rule',
+            description: 'Add a conditional logic rule to a field using a custom expression. Use this for complex conditions that field-based rules cannot express (e.g. arithmetic, multi-field combinations). The expression is evaluated in a safe sandbox — NOT full JavaScript. CRITICAL SYNTAX: field IDs MUST be wrapped in curly braces: {fieldId}. Example: `{text-3} > 4 && {rating-1} < 3`. Available operators: +,-,*,/,%, comparisons (==,!=,===,!==,>,>=,<,<=), logical (&&,||,!), property access (.length, .count on field refs). NOT available: ANY function calls (parseInt, parseFloat, Object.values, .includes, .find, .filter, etc.), bare field names without {}, loops, or assignments. NEVER use parseInt() — text fields with inputType "number" and rating/slider fields already resolve to numbers automatically, use them directly. Field values in expressions: text/longtext with inputType "number" → number. text/longtext otherwise → string. radio/dropdown/boolean/slider/rating → option label string (NOT id). check/multiselectdropdown/ranking → array of option label strings (use .count for length). singlematrix/multimatrix → object keyed by rowId (use .count for answered row count). Valid examples: `{f1} > 4 && {f2} < 3`, `{f3}.length > 0`, `{f4} == "Yes"`. Invalid: `parseInt({f1}) > 4`, `f1 > 4` (missing braces).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    effect: {
+                        type: 'string',
+                        enum: ['visible', 'enable', 'required'],
+                    },
+                    expression: {
+                        type: 'string',
+                        description: 'Expression string. Use field IDs as variable names. No method calls allowed.',
+                    },
+                },
+                required: ['effect', 'expression'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'remove_rule',
+            description: 'Remove a conditional logic rule from a field by its 0-based index. Use get_field or get_definition to see existing rules and their indices.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fieldQuestion: { type: 'string' },
+                    fieldId: { type: 'string' },
+                    ruleIndex: {
+                        type: 'number',
+                        description: '0-based index of the rule to remove.',
+                    },
+                },
+                required: ['ruleIndex'],
+            },
+        },
+    },
+];