@zudello/mcp 1.1.2

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

@@ -0,0 +1,27 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloGetDataset: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            uuid: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        uuid: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        dataset: import("../../../services/zudello/admin.js").ZudelloDataset | undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        dataset?: undefined;
+    }>;
+};
+//# sourceMappingURL=get-dataset.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;qBAsBnB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,eACV,WAAW;;;;;;;;;CAuB3B,CAAC"}

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

@@ -0,0 +1,45 @@
+import { logger } from "../../../utils/logger.js";
+import { getZudelloDataset } from "../../../services/zudello/admin.js";
+export const zudelloGetDataset = {
+    name: "zudelloGetDataset",
+    description: `Get full details of a specific dataset by UUID.
+
+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: {
+            uuid: {
+                type: "string",
+                description: "UUID of the dataset to retrieve",
+            },
+        },
+        required: ["uuid"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.debug("zudelloGetDataset executed", input);
+            const response = await getZudelloDataset(authContext, input.uuid);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to get dataset");
+            }
+            return {
+                success: true,
+                dataset: response.data,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloGetDataset error", input, error);
+            return {
+                success: false,
+                error: error.message,
+            };
+        }
+    },
+};
+//# sourceMappingURL=get-dataset.js.map

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

@@ -0,0 +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;;;;;;;;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/index.d.ts

@@ -0,0 +1,5 @@
+export { zudelloListDatasets } from "./list-datasets.js";
+export { zudelloGetDataset } from "./get-dataset.js";
+export { zudelloCreateDataset } from "./create-dataset.js";
+export { zudelloUpdateDataset } from "./update-dataset.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/admin/datasets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/admin/datasets/index.js

@@ -0,0 +1,5 @@
+export { zudelloListDatasets } from "./list-datasets.js";
+export { zudelloGetDataset } from "./get-dataset.js";
+export { zudelloCreateDataset } from "./create-dataset.js";
+export { zudelloUpdateDataset } from "./update-dataset.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/admin/datasets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/admin/datasets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,33 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloListDatasets: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            model: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    execute: (input: {
+        model?: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        datasets: {
+            uuid: string;
+            name: string;
+            datasetType: string;
+            columnDefs: import("../../../services/zudello/admin.js").DatasetColumnDef[] | undefined;
+        }[];
+        count: number;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        datasets: never[];
+        count?: undefined;
+    }>;
+};
+//# sourceMappingURL=list-datasets.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;qBAuBrB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,eACZ,WAAW;;;;;;;;;;;;;;;;CAwC3B,CAAC"}

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

@@ -0,0 +1,59 @@
+import { logger } from "../../../utils/logger.js";
+import { listZudelloDatasets } from "../../../services/zudello/admin.js";
+export const zudelloListDatasets = {
+    name: "zudelloListDatasets",
+    description: `List all datasets in Zudello with their names, UUIDs, and types.
+
+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: {
+            model: {
+                type: "string",
+                description: "Optional: Filter datasets by model type",
+            },
+        },
+    },
+    execute: async (input, authContext) => {
+        try {
+            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");
+            }
+            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,
+                    datasetType: d.datasetType,
+                    columnDefs: d.columnDefs,
+                })),
+                count: datasets.length,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloListDatasets error", { model: input.model }, error);
+            return {
+                success: false,
+                error: error.message,
+                datasets: [],
+            };
+        }
+    },
+};
+//# sourceMappingURL=list-datasets.js.map

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

@@ -0,0 +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;;;;;;;;;;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

@@ -0,0 +1,77 @@
+import type { AuthContext } from "../../../context/auth.js";
+import type { DatasetColumnDef } from "../../../services/zudello/admin.js";
+export declare const zudelloUpdateDataset: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            uuid: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            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[];
+                };
+            };
+            datasetType: {
+                type: string;
+                description: string;
+            };
+            onDimensionMismatch: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        uuid: string;
+        name: string;
+        columnDefs: DatasetColumnDef[];
+        datasetType?: string;
+        onDimensionMismatch?: "fail_sentence" | "skip_sentence" | "skip_line";
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        dataset: import("../../../services/zudello/admin.js").ZudelloDataset | undefined;
+        message: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        dataset?: undefined;
+        message?: undefined;
+    }>;
+};
+//# sourceMappingURL=update-dataset.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,79 @@
+import { logger } from "../../../utils/logger.js";
+import { updateZudelloDataset } from "../../../services/zudello/admin.js";
+export const zudelloUpdateDataset = {
+    name: "zudelloUpdateDataset",
+    description: `Update an existing dataset schema in Zudello.
+
+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: {
+            uuid: {
+                type: "string",
+                description: "UUID of the dataset to update"
+            },
+            name: {
+                type: "string",
+                description: "Name 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"]
+                }
+            },
+            datasetType: {
+                type: "string",
+                description: "Optional: Type categorization for the dataset"
+            },
+            onDimensionMismatch: {
+                type: "string",
+                enum: ["fail_sentence", "skip_sentence", "skip_line"],
+                description: "Optional: How to handle dimension mismatches"
+            }
+        },
+        required: ["uuid", "name", "columnDefs"]
+    },
+    execute: async (input, authContext) => {
+        try {
+            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");
+            }
+            return {
+                success: true,
+                dataset: response.data,
+                message: "Dataset updated successfully"
+            };
+        }
+        catch (error) {
+            logger.error("zudelloUpdateDataset error", { uuid: input.uuid }, error);
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+};
+//# sourceMappingURL=update-dataset.js.map

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

@@ -0,0 +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;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

@@ -0,0 +1,44 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloCreateField: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            label: {
+                type: string;
+                description: string;
+            };
+            model_name: {
+                type: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        path: string;
+        label: string;
+        model_name: string;
+        context?: Record<string, string[]>;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        field: import("../../../services/zudello/admin.js").ZudelloFieldSettings | undefined;
+        message: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        field?: undefined;
+        message?: undefined;
+    }>;
+};
+//# sourceMappingURL=create-field.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;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

@@ -0,0 +1,99 @@
+import { logger } from "../../../utils/logger.js";
+import { createZudelloFieldSettings } from "../../../services/zudello/admin.js";
+export const zudelloCreateField = {
+    name: "zudelloCreateField",
+    description: `Create a new custom field or override a system field's behavior in Zudello.
+
+## 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: {
+            path: {
+                type: "string",
+                description: "Field path (internal identifier)"
+            },
+            label: {
+                type: "string",
+                description: "Display label for the field"
+            },
+            model_name: {
+                type: "string",
+                description: "Model name this field belongs to"
+            },
+            context: {
+                type: "object",
+                description: "Optional: Module/submodule context mapping (e.g., {PURCHASING: ['INVOICE']})"
+            }
+        },
+        required: ["path", "label", "model_name"]
+    },
+    execute: async (input, authContext) => {
+        try {
+            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,
+                model_name: input.model_name,
+            }, input.context || {});
+            if (!response.success) {
+                throw new Error(response.error || "Failed to create field");
+            }
+            return {
+                success: true,
+                field: response.data,
+                message: `Field "${input.label}" created successfully`
+            };
+        }
+        catch (error) {
+            logger.error("zudelloCreateField error", { path: input.path }, error);
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+};
+//# sourceMappingURL=create-field.js.map

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

@@ -0,0 +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,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

@@ -0,0 +1,27 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloGetField: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            uuid: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        uuid: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        field: import("../../../services/zudello/admin.js").ZudelloFieldSettings | undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        field?: undefined;
+    }>;
+};
+//# sourceMappingURL=get-field.d.ts.map

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

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

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

@@ -0,0 +1,46 @@
+import { logger } from "../../../utils/logger.js";
+import { getZudelloField } from "../../../services/zudello/admin.js";
+export const zudelloGetField = {
+    name: "zudelloGetField",
+    description: `Get full details of a specific field settings by UUID.
+
+Returns the complete field configuration including:
+- payload.path: Field path
+- payload.label: Display label
+- payload.model_name: Target model
+- payload.form_data: Editor, validations, and rules
+- context: Module/submodule scope
+
+Use zudelloListFields first to find the UUID.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            uuid: {
+                type: "string",
+                description: "UUID of the field to retrieve",
+            },
+        },
+        required: ["uuid"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.debug("zudelloGetField executed", input);
+            const response = await getZudelloField(authContext, input.uuid);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to get field");
+            }
+            return {
+                success: true,
+                field: response.data,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloGetField error", input, error);
+            return {
+                success: false,
+                error: error.message,
+            };
+        }
+    },
+};
+//# sourceMappingURL=get-field.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-field.js","sourceRoot":"","sources":["../../../../src/tools/admin/fields/get-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAGrE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;8CAS+B;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;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,0BAA0B,EAAE,KAAK,CAAC,CAAC;YAEhD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAEhE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC;YAC3D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,QAAQ,CAAC,IAAI;aACrB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/fields/index.d.ts

@@ -0,0 +1,5 @@
+export { zudelloListFields } from "./list-fields.js";
+export { zudelloGetField } from "./get-field.js";
+export { zudelloCreateField } from "./create-field.js";
+export { zudelloUpdateField } from "./update-field.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/admin/fields/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/fields/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tools/admin/fields/index.js

@@ -0,0 +1,5 @@
+export { zudelloListFields } from "./list-fields.js";
+export { zudelloGetField } from "./get-field.js";
+export { zudelloCreateField } from "./create-field.js";
+export { zudelloUpdateField } from "./update-field.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/admin/fields/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/admin/fields/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}