@zudello/modelcontextprotocol 1.0.0 → 1.1.1

package/dist/tools/admin/datasets/create-dataset.js

@@ -2,10 +2,42 @@ import { logger } from "../../../utils/logger.js";
 import { createZudelloDataset } from "../../../services/zudello/admin.js";
 export const zudelloCreateDataset = {
     name: "zudelloCreateDataset",
-    description: `Create a new dataset.
+    description: `Create a new dataset in Zudello.
 
-Datasets define data sources and collections. Use this to set up new data structures.
-Requires name, model type, and optional description and configuration.`,
+## Dataset Types
+- "" (empty): Generic lookup/mapping table
+- "approval_doa": Delegation of Authority with user/limit
+- "approval_doa_group": DOA using user groups
+- "approval_management_tree": Manager hierarchy
+- "approval_user_limit": User-specific limits
+
+## Editor Types
+- TEXT: Free text input
+- NUMERIC: Number input
+- DD_SINGLE: Single-select dropdown (requires select config)
+- DD_MULTIPLE: Multi-select dropdown (requires select config)
+- DATE: Date picker
+
+## Common Storage Getters for Dropdowns
+- activeTeamUsers: Team users (label: "{first_name} {last_name}")
+- departmentList: Departments (label: "{code} - {name}")
+- projectList: Projects (label: "{code} - {name}")
+- supplierList: Suppliers (label: "{code} - {trading_name}")
+- customerList: Customers (label: "{code} - {trading_name}")
+- getLocations: Locations (label: "{code} - {name}")
+- getSubsidiaries: Entities (label: "{code} - {name}")
+- glAccountList: GL Accounts (label: "{code} - {name}")
+- costCentreList: Cost Centres (label: "{code} - {name}")
+- UserGroup: User groups (label: "name")
+
+## Approval Field Values
+- "": No approval significance
+- "step_name": Step identifier
+- "user": Approver user
+- "user_group": Approver group
+- "limit": Approval limit threshold
+- "dimension": Dimensional filter for DOA
+- "manager": Manager in hierarchy`,
     inputSchema: {
         type: "object",
         properties: {
@@ -13,30 +45,37 @@ Requires name, model type, and optional description and configuration.`,
                 type: "string",
                 description: "Name of the dataset"
             },
-            model: {
-                type: "string",
-                description: "Model type for the dataset"
+            columnDefs: {
+                type: "array",
+                description: "Array of column definitions with id, name, type, and optional required/options",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string", description: "Column identifier" },
+                        name: { type: "string", description: "Column display name" },
+                        type: { type: "string", description: "Column data type" },
+                        required: { type: "boolean", description: "Whether column is required" },
+                        options: { type: "object", description: "Additional column options" }
+                    },
+                    required: ["id", "name", "type"]
+                }
             },
-            description: {
+            datasetType: {
                 type: "string",
-                description: "Optional: Description of the dataset purpose"
+                description: "Optional: Type categorization for the dataset"
             },
-            configuration: {
-                type: "object",
-                description: "Optional: Dataset configuration settings"
+            onDimensionMismatch: {
+                type: "string",
+                enum: ["fail_sentence", "skip_sentence", "skip_line"],
+                description: "Optional: How to handle dimension mismatches"
             }
         },
-        required: ["name", "model"]
+        required: ["name", "columnDefs"]
     },
     execute: async (input, authContext) => {
         try {
-            logger.info("zudelloCreateDataset executed", input);
-            const response = await createZudelloDataset(authContext, {
-                name: input.name,
-                model: input.model,
-                description: input.description,
-                configuration: input.configuration
-            });
+            logger.info("zudelloCreateDataset executed", { name: input.name, columnCount: input.columnDefs.length });
+            const response = await createZudelloDataset(authContext, input.name, input.columnDefs, input.datasetType || "", input.onDimensionMismatch);
             if (!response.success) {
                 throw new Error(response.error || "Failed to create dataset");
             }
@@ -47,7 +86,7 @@ Requires name, model type, and optional description and configuration.`,
             };
         }
         catch (error) {
-            logger.error("zudelloCreateDataset error", input, error);
+            logger.error("zudelloCreateDataset error", { name: input.name }, error);
             return {
                 success: false,
                 error: error.message

package/dist/tools/admin/datasets/create-dataset.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-dataset.js","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/create-dataset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAG1E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;uEAGwD;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0CAA0C;aACxD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KAC5B;IACD,OAAO,EAAE,KAAK,EACZ,KAKC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;YAEpD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE;gBACvD,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;aACnC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;YAChE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,QAAQ,CAAC,IAAI;gBACtB,OAAO,EAAE,YAAY,KAAK,CAAC,IAAI,wBAAwB;aACxD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAClE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"create-dataset.js","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/create-dataset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAI1E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAmCmB;IAChC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,gFAAgF;gBAC7F,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;wBACxD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;wBAC5D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;wBACzD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,4BAA4B,EAAE;wBACxE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;qBACtE;oBACD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC;iBACjC;aACF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,WAAW,CAAC;gBACrD,WAAW,EAAE,8CAA8C;aAC5D;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;KACjC;IACD,OAAO,EAAE,KAAK,EACZ,KAKC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAEzG,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CACzC,WAAW,EACX,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,WAAW,IAAI,EAAE,EACvB,KAAK,CAAC,mBAAmB,CAC1B,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;YAChE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,QAAQ,CAAC,IAAI;gBACtB,OAAO,EAAE,YAAY,KAAK,CAAC,IAAI,wBAAwB;aACxD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAc,CAAC,CAAC;YACjF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/datasets/get-dataset.d.ts

@@ -16,7 +16,7 @@ export declare const zudelloGetDataset: {
         uuid: string;
     }, authContext: AuthContext) => Promise<{
         success: boolean;
-        dataset: import("../../../services/zudello/admin.js").Dataset | undefined;
+        dataset: import("../../../services/zudello/admin.js").ZudelloDataset | undefined;
         error?: undefined;
     } | {
         success: boolean;

package/dist/tools/admin/datasets/get-dataset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-dataset.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/get-dataset.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;qBAgBnB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,eACV,WAAW;;;;;;;;;CAuB3B,CAAC"}
+{"version":3,"file":"get-dataset.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/get-dataset.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;qBAsBnB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,eACV,WAAW;;;;;;;;;CAuB3B,CAAC"}

package/dist/tools/admin/datasets/get-dataset.js

@@ -2,9 +2,15 @@ import { logger } from "../../../utils/logger.js";
 import { getZudelloDataset } from "../../../services/zudello/admin.js";
 export const zudelloGetDataset = {
     name: "zudelloGetDataset",
-    description: `Get details for a specific dataset.
+    description: `Get full details of a specific dataset by UUID.
 
-Returns complete dataset configuration including name, model, description, and settings.`,
+Returns the complete dataset schema including:
+- name: Display name
+- settings.datasetType: Type for approval workflows
+- settings.columnDefs: Array of column definitions
+- settings.on_dimension_mismatch: Handling for unmatched dimensions
+
+Use zudelloListDatasets first to find the UUID.`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/admin/datasets/get-dataset.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-dataset.js","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/get-dataset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAGvE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;yFAE0E;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EACZ,KAAuB,EACvB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YAElD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAElE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAC;YAC7D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,QAAQ,CAAC,IAAI;aACvB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC/D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-dataset.js","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/get-dataset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAGvE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;gDAQiC;IAC9C,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EACZ,KAAuB,EACvB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YAElD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAElE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAC;YAC7D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,QAAQ,CAAC,IAAI;aACvB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC/D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/datasets/list-datasets.d.ts

@@ -18,10 +18,8 @@ export declare const zudelloListDatasets: {
         datasets: {
             uuid: string;
             name: string;
-            description: string | undefined;
-            model: string;
-            createdAt: string;
-            updatedAt: string;
+            datasetType: string;
+            columnDefs: import("../../../services/zudello/admin.js").DatasetColumnDef[] | undefined;
         }[];
         count: number;
         error?: undefined;

package/dist/tools/admin/datasets/list-datasets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-datasets.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/list-datasets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;qBAgBrB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,eACZ,WAAW;;;;;;;;;;;;;;;;;;CAkC3B,CAAC"}
+{"version":3,"file":"list-datasets.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/list-datasets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;qBAuBrB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,eACZ,WAAW;;;;;;;;;;;;;;;;CAwC3B,CAAC"}

package/dist/tools/admin/datasets/list-datasets.js

@@ -2,10 +2,17 @@ import { logger } from "../../../utils/logger.js";
 import { listZudelloDatasets } from "../../../services/zudello/admin.js";
 export const zudelloListDatasets = {
     name: "zudelloListDatasets",
-    description: `List all datasets configured for the team.
+    description: `List all datasets in Zudello with their names, UUIDs, and types.
 
-Datasets define data sources and collections used across the system.
-Returns dataset names, models, descriptions, and configuration details.`,
+Datasets are virtual tables that can be used for:
+- Lookup/mapping tables (empty datasetType)
+- Approval DOA workflows (datasetType: approval_doa, approval_doa_group)
+- Manager hierarchy (datasetType: approval_management_tree)
+- User approval limits (datasetType: approval_user_limit)
+
+Returns: uuid, name, datasetType, and optionally columnDefs.
+
+Set includeColumns=true when looking for existing approval datasets to reference in sentences - this shows the schema structure including dimension columns and approval fields.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -17,27 +24,30 @@ Returns dataset names, models, descriptions, and configuration details.`,
     },
     execute: async (input, authContext) => {
         try {
-            logger.debug("zudelloListDatasets executed", input);
-            const response = await listZudelloDatasets(authContext, { model: input.model });
+            logger.debug("zudelloListDatasets executed", { model: input.model });
+            // Note: The API doesn't support model filtering, but we can filter client-side if needed
+            const response = await listZudelloDatasets(authContext, { includeColumns: true });
             if (!response.success) {
                 throw new Error(response.error || "Failed to list datasets");
             }
-            const datasets = response.data || [];
+            let datasets = response.data || [];
+            // Client-side filtering if model is specified
+            if (input.model) {
+                datasets = datasets.filter((d) => d.datasetType?.toLowerCase().includes(input.model.toLowerCase()));
+            }
             return {
                 success: true,
                 datasets: datasets.map((d) => ({
                     uuid: d.uuid,
                     name: d.name,
-                    description: d.description,
-                    model: d.model,
-                    createdAt: d.createdAt,
-                    updatedAt: d.updatedAt,
+                    datasetType: d.datasetType,
+                    columnDefs: d.columnDefs,
                 })),
                 count: datasets.length,
             };
         }
         catch (error) {
-            logger.error("zudelloListDatasets error", input, error);
+            logger.error("zudelloListDatasets error", { model: input.model }, error);
             return {
                 success: false,
                 error: error.message,

package/dist/tools/admin/datasets/list-datasets.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-datasets.js","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/list-datasets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGzE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;wEAGyD;IACtE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;SACF;KACF;IACD,OAAO,EAAE,KAAK,EACZ,KAAyB,EACzB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YAEpD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAEhF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,yBAAyB,CAAC,CAAC;YAC/D,CAAC;YAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YAErC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,SAAS,EAAE,CAAC,CAAC,SAAS;iBACvB,CAAC,CAAC;gBACH,KAAK,EAAE,QAAQ,CAAC,MAAM;aACvB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,QAAQ,EAAE,EAAE;aACb,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"list-datasets.js","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/list-datasets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGzE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;;;;;;iLAUkK;IAC/K,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;SACF;KACF;IACD,OAAO,EAAE,KAAK,EACZ,KAAyB,EACzB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAErE,yFAAyF;YACzF,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;YAElF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,yBAAyB,CAAC,CAAC;YAC/D,CAAC;YAED,IAAI,QAAQ,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YAEnC,8CAA8C;YAC9C,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAM,CAAC,WAAW,EAAE,CAAC,CAClE,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;iBACzB,CAAC,CAAC;gBACH,KAAK,EAAE,QAAQ,CAAC,MAAM;aACvB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,KAAc,CAAC,CAAC;YAClF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,QAAQ,EAAE,EAAE;aACb,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/datasets/update-dataset.d.ts

@@ -1,4 +1,5 @@
 import type { AuthContext } from "../../../context/auth.js";
+import type { DatasetColumnDef } from "../../../services/zudello/admin.js";
 export declare const zudelloUpdateDataset: {
     name: string;
     description: string;
@@ -13,25 +14,57 @@ export declare const zudelloUpdateDataset: {
                 type: string;
                 description: string;
             };
-            description: {
+            columnDefs: {
                 type: string;
                 description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        id: {
+                            type: string;
+                            description: string;
+                        };
+                        name: {
+                            type: string;
+                            description: string;
+                        };
+                        type: {
+                            type: string;
+                            description: string;
+                        };
+                        required: {
+                            type: string;
+                            description: string;
+                        };
+                        options: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
             };
-            configuration: {
+            datasetType: {
                 type: string;
                 description: string;
             };
+            onDimensionMismatch: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };
     execute: (input: {
         uuid: string;
-        name?: string;
-        description?: string;
-        configuration?: Record<string, unknown>;
+        name: string;
+        columnDefs: DatasetColumnDef[];
+        datasetType?: string;
+        onDimensionMismatch?: "fail_sentence" | "skip_sentence" | "skip_line";
     }, authContext: AuthContext) => Promise<{
         success: boolean;
-        dataset: import("../../../services/zudello/admin.js").Dataset | undefined;
+        dataset: import("../../../services/zudello/admin.js").ZudelloDataset | undefined;
         message: string;
         error?: undefined;
     } | {

package/dist/tools/admin/datasets/update-dataset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-dataset.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/update-dataset.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;qBA6BtB;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACzC,eACY,WAAW;;;;;;;;;;;CA4B3B,CAAC"}
+{"version":3,"file":"update-dataset.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/update-dataset.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAuDtB;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,gBAAgB,EAAE,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,mBAAmB,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,WAAW,CAAC;KACvE,eACY,WAAW;;;;;;;;;;;CA+B3B,CAAC"}

package/dist/tools/admin/datasets/update-dataset.js

@@ -2,10 +2,20 @@ import { logger } from "../../../utils/logger.js";
 import { updateZudelloDataset } from "../../../services/zudello/admin.js";
 export const zudelloUpdateDataset = {
     name: "zudelloUpdateDataset",
-    description: `Update an existing dataset.
+    description: `Update an existing dataset schema in Zudello.
 
-Modify dataset name, description, or configuration settings.
-Changes affect how data is structured and accessed.`,
+IMPORTANT: Always use zudelloGetDataset first to retrieve the current schema.
+When updating, provide the complete column definitions - columns not included will be removed.
+
+To preserve existing columns:
+1. Get the current dataset with zudelloGetDataset
+2. Modify the columnDefs as needed
+3. Pass all columns (modified and unchanged) to this tool
+
+Column IDs (colId) must be preserved for existing columns to maintain data integrity.
+New columns will get auto-generated IDs.
+
+See zudelloCreateDataset description for column configuration details.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -15,27 +25,39 @@ Changes affect how data is structured and accessed.`,
             },
             name: {
                 type: "string",
-                description: "Optional: New name for the dataset"
+                description: "Name for the dataset"
             },
-            description: {
+            columnDefs: {
+                type: "array",
+                description: "Array of column definitions with id, name, type, and optional required/options",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string", description: "Column identifier" },
+                        name: { type: "string", description: "Column display name" },
+                        type: { type: "string", description: "Column data type" },
+                        required: { type: "boolean", description: "Whether column is required" },
+                        options: { type: "object", description: "Additional column options" }
+                    },
+                    required: ["id", "name", "type"]
+                }
+            },
+            datasetType: {
                 type: "string",
-                description: "Optional: New description"
+                description: "Optional: Type categorization for the dataset"
             },
-            configuration: {
-                type: "object",
-                description: "Optional: Updated configuration settings"
+            onDimensionMismatch: {
+                type: "string",
+                enum: ["fail_sentence", "skip_sentence", "skip_line"],
+                description: "Optional: How to handle dimension mismatches"
             }
         },
-        required: ["uuid"]
+        required: ["uuid", "name", "columnDefs"]
     },
     execute: async (input, authContext) => {
         try {
-            logger.info("zudelloUpdateDataset executed", input);
-            const response = await updateZudelloDataset(authContext, input.uuid, {
-                name: input.name,
-                description: input.description,
-                configuration: input.configuration
-            });
+            logger.info("zudelloUpdateDataset executed", { uuid: input.uuid, name: input.name });
+            const response = await updateZudelloDataset(authContext, input.uuid, input.name, input.columnDefs, input.datasetType || "", input.onDimensionMismatch);
             if (!response.success) {
                 throw new Error(response.error || "Failed to update dataset");
             }
@@ -46,7 +68,7 @@ Changes affect how data is structured and accessed.`,
             };
         }
         catch (error) {
-            logger.error("zudelloUpdateDataset error", input, error);
+            logger.error("zudelloUpdateDataset error", { uuid: input.uuid }, error);
             return {
                 success: false,
                 error: error.message

package/dist/tools/admin/datasets/update-dataset.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-dataset.js","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/update-dataset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAG1E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;oDAGqC;IAClD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;aAClD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2BAA2B;aACzC;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0CAA0C;aACxD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EACZ,KAKC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;YAEpD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE;gBACnE,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;aACnC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;YAChE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,QAAQ,CAAC,IAAI;gBACtB,OAAO,EAAE,8BAA8B;aACxC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAClE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"update-dataset.js","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/update-dataset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAI1E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;;;;;;;;uEAawD;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sBAAsB;aACpC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,gFAAgF;gBAC7F,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;wBACxD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;wBAC5D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;wBACzD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,4BAA4B,EAAE;wBACxE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;qBACtE;oBACD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC;iBACjC;aACF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,WAAW,CAAC;gBACrD,WAAW,EAAE,8CAA8C;aAC5D;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC;KACzC;IACD,OAAO,EAAE,KAAK,EACZ,KAMC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAErF,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CACzC,WAAW,EACX,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,WAAW,IAAI,EAAE,EACvB,KAAK,CAAC,mBAAmB,CAC1B,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;YAChE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,QAAQ,CAAC,IAAI;gBACtB,OAAO,EAAE,8BAA8B;aACxC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAc,CAAC,CAAC;YACjF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/fields/create-field.d.ts

@@ -5,7 +5,7 @@ export declare const zudelloCreateField: {
     inputSchema: {
         type: "object";
         properties: {
-            name: {
+            path: {
                 type: string;
                 description: string;
             };
@@ -13,19 +13,11 @@ export declare const zudelloCreateField: {
                 type: string;
                 description: string;
             };
-            type: {
+            model_name: {
                 type: string;
                 description: string;
             };
-            model: {
-                type: string;
-                description: string;
-            };
-            required: {
-                type: string;
-                description: string;
-            };
-            options: {
+            context: {
                 type: string;
                 description: string;
             };
@@ -33,15 +25,13 @@ export declare const zudelloCreateField: {
         required: string[];
     };
     execute: (input: {
-        name: string;
+        path: string;
         label: string;
-        type: string;
-        model: string;
-        required?: boolean;
-        options?: Record<string, unknown>;
+        model_name: string;
+        context?: Record<string, string[]>;
     }, authContext: AuthContext) => Promise<{
         success: boolean;
-        field: import("../../../services/zudello/admin.js").Field | undefined;
+        field: import("../../../services/zudello/admin.js").ZudelloFieldSettings | undefined;
         message: string;
         error?: undefined;
     } | {

package/dist/tools/admin/fields/create-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-field.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/fields/create-field.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAqCpB;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,eACY,WAAW;;;;;;;;;;;CA+B3B,CAAC"}
+{"version":3,"file":"create-field.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/fields/create-field.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;qBAuEpB;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;KACpC,eACY,WAAW;;;;;;;;;;;CAgC3B,CAAC"}

package/dist/tools/admin/fields/create-field.js

@@ -1,52 +1,83 @@
 import { logger } from "../../../utils/logger.js";
-import { createZudelloField } from "../../../services/zudello/admin.js";
+import { createZudelloFieldSettings } from "../../../services/zudello/admin.js";
 export const zudelloCreateField = {
     name: "zudelloCreateField",
-    description: `Create a new custom field.
+    description: `Create a new custom field or override a system field's behavior in Zudello.
 
-Define a new field with name, type, validation rules, and display settings.
-Fields extend data models with custom attributes.`,
+## Path Naming Conventions
+- System field override: Use existing path (e.g., 'document_number', 'payment_method', 'code')
+- Custom header field: 'custom__fieldname' (e.g., 'custom__employer_name')
+- Custom line field: 'lines__custom__fieldname' (e.g., 'lines__custom__vehicleRegistrationNumber')
+
+## Editor Types
+- TEXT: Simple text input. Optional 'mask' for formatting (e.g., 'XXX-XX-XXXX', '######')
+- NUMERIC: Number input. Set 'numeric.precision' (0, 2, or 4)
+- BOOLEAN: Checkbox. Optional 'default' value
+- DATE: Date picker
+- DD_SINGLE: Single-select dropdown (requires 'select' config)
+- DD_MULTIPLE: Multi-select dropdown (requires 'select' config)
+
+## Common Storage Getters for Dropdowns
+- activeTeamUsers: Team users (label: "{first_name} {last_name}")
+- departmentList: Departments (label: "{code} - {name}")
+- getLocations: Locations (label: "{code} - {name}")
+- getSubsidiaries: Entities (label: "{code} - {name}")
+- glAccountList: GL Accounts (label: "{code} - {name}")
+- costCentreList: Cost Centres (label: "{code} - {name}")
+- taxRateList: Tax Rates (label: "{code} - {name}")
+- projectList: Projects (label: "{code} - {name}")
+- supplierList: Suppliers (label: "{code} - {trading_name}")
+- customerList: Customers (label: "{code} - {trading_name}")
+- PaymentMethod: Payment methods (label: "name")
+- ExpenseCategory: Expense categories (label: "name")
+
+## Validations
+- required: Field must have a value. Params: {}
+- requiredIf: Conditional. Params: {path, value, condition: "==", category: "field", subcategory: "static"}
+- number: Must be numeric. Params: {}
+- maxLength: Max string length. Params: {value: 40}
+- minLength: Min string length. Params: {value: 6}
+- Levels: "error" (blocks save), "warning" (allows with warning), "info" (informational)
+
+## Rules
+- visibleIf: Show field conditionally. Params: {path, value, condition: "==", category: "field", subcategory: "static"}
+- computeField: Auto-generate value. Params: {template: "PO-{{ \\"%05d\\" % counter }}", counterKey: "{{ module }}-{{ submodule }}"}
+
+## Context Scoping
+- {} (empty): Applies to all modules/submodules
+- {"MODULE": []}: Applies to all submodules in module
+- {"MODULE": ["SUBMODULE"]}: Applies to specific submodule
+- {"SALES": ["INVOICE"], "PURCHASING": ["INVOICE"]}: Multiple modules`,
     inputSchema: {
         type: "object",
         properties: {
-            name: {
+            path: {
                 type: "string",
-                description: "Field name (internal identifier)"
+                description: "Field path (internal identifier)"
             },
             label: {
                 type: "string",
                 description: "Display label for the field"
             },
-            type: {
-                type: "string",
-                description: "Field type (text, number, date, select, etc.)"
-            },
-            model: {
+            model_name: {
                 type: "string",
-                description: "Model type this field belongs to"
-            },
-            required: {
-                type: "boolean",
-                description: "Optional: Whether field is required"
+                description: "Model name this field belongs to"
             },
-            options: {
+            context: {
                 type: "object",
-                description: "Optional: Field-specific options and validation rules"
+                description: "Optional: Module/submodule context mapping (e.g., {PURCHASING: ['INVOICE']})"
             }
         },
-        required: ["name", "label", "type", "model"]
+        required: ["path", "label", "model_name"]
     },
     execute: async (input, authContext) => {
         try {
-            logger.info("zudelloCreateField executed", input);
-            const response = await createZudelloField(authContext, {
-                name: input.name,
+            logger.info("zudelloCreateField executed", { path: input.path, label: input.label, model_name: input.model_name });
+            const response = await createZudelloFieldSettings(authContext, {
+                path: input.path,
                 label: input.label,
-                type: input.type,
-                model: input.model,
-                required: input.required,
-                options: input.options
-            });
+                model_name: input.model_name,
+            }, input.context || {});
             if (!response.success) {
                 throw new Error(response.error || "Failed to create field");
             }
@@ -57,7 +88,7 @@ Fields extend data models with custom attributes.`,
             };
         }
         catch (error) {
-            logger.error("zudelloCreateField error", input, error);
+            logger.error("zudelloCreateField error", { path: input.path }, error);
             return {
                 success: false,
                 error: error.message

package/dist/tools/admin/fields/create-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-field.js","sourceRoot":"","sources":["../../../../src/tools/admin/fields/create-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAGxE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;;kDAGmC;IAChD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,qCAAqC;aACnD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;aACrE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;KAC7C;IACD,OAAO,EAAE,KAAK,EACZ,KAOC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;YAElD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE;gBACrD,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC;YAC9D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,QAAQ,CAAC,IAAI;gBACpB,OAAO,EAAE,UAAU,KAAK,CAAC,KAAK,wBAAwB;aACvD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAChE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"create-field.js","sourceRoot":"","sources":["../../../../src/tools/admin/fields/create-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGhF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sEA6CuD;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8EAA8E;aAC5F;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC;KAC1C;IACD,OAAO,EAAE,KAAK,EACZ,KAKC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YAEnH,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAC/C,WAAW,EACX;gBACE,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,EACD,KAAK,CAAC,OAAO,IAAI,EAAE,CACpB,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC;YAC9D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,QAAQ,CAAC,IAAI;gBACpB,OAAO,EAAE,UAAU,KAAK,CAAC,KAAK,wBAAwB;aACvD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAc,CAAC,CAAC;YAC/E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/fields/get-field.d.ts

@@ -16,7 +16,7 @@ export declare const zudelloGetField: {
         uuid: string;
     }, authContext: AuthContext) => Promise<{
         success: boolean;
-        field: import("../../../services/zudello/admin.js").Field | undefined;
+        field: import("../../../services/zudello/admin.js").ZudelloFieldSettings | undefined;
         error?: undefined;
     } | {
         success: boolean;