@zudello/modelcontextprotocol 1.1.0 → 1.1.1

package/dist/tools/documents/document-types/get-document-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-document-type.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/get-document-type.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;qBAIV,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"get-document-type.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/get-document-type.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;qBAcV,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}

package/dist/tools/documents/document-types/get-document-type.js

@@ -2,7 +2,17 @@ import { logger } from "../../../utils/logger.js";
 import { getZudelloDocumentType } from "../../../services/zudello/index.js";
 export const zudelloGetDocumentType = {
     name: "zudelloGetDocumentType",
-    description: "Get details for a specific document type",
+    description: `Get full details of a specific document type by UUID.
+
+Returns the complete document type configuration including:
+- Metadata (display, type, module, submodule, icon)
+- settings.fields: Array of field definitions with path, label, editor config, validations
+- settings.sections: Form sections (HEADER, CONTACT, LINES, TOTALS, etc.)
+- settings.extensions: Enabled form behaviors and validations
+- settings.statuses: Default status on create/revert
+
+Use zudelloListDocumentTypes first to find the UUID of the document type you need.
+This returns the RAW/EDITABLE version - for the rendered user view with merged field metadata, use zudelloGetMergedFormMetadata instead.`,
     inputSchema: { type: "object", properties: { uuid: { type: "string" } }, required: ["uuid"] },
     execute: async (input, authContext) => {
         try {

package/dist/tools/documents/document-types/get-document-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-document-type.js","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/get-document-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,0CAA0C;IACvD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;IACtG,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACpE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-document-type.js","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/get-document-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE;;;;;;;;;;yIAU0H;IACvI,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;IACtG,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACpE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/documents/document-types/get-merged-form-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-merged-form-metadata.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/get-merged-form-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,4BAA4B;;;;;;;;;;;;qBAIhB,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"get-merged-form-metadata.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/get-merged-form-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,4BAA4B;;;;;;;;;;;;qBAgBhB,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}

package/dist/tools/documents/document-types/get-merged-form-metadata.js

@@ -2,7 +2,19 @@ import { logger } from "../../../utils/logger.js";
 import { getZudelloMergedFormMetadata } from "../../../services/zudello/index.js";
 export const zudelloGetMergedFormMetadata = {
     name: "zudelloGetMergedFormMetadata",
-    description: "Get merged form metadata for a document type",
+    description: `Get the rendered/merged form metadata for a document type. This returns the document type with all field metadata merged from field settings.
+
+This is the END-USER view of the form - use this when you need to understand what fields users actually see.
+For the raw/editable configuration, use zudelloGetDocumentType instead.
+
+The merged form includes:
+- All field definitions with their complete editor configuration
+- Section visibility and ordering
+- Validation rules merged from field settings
+- Extension behaviors
+
+Identify the document type by module, submodule, and document type key (property).
+Example: module='PURCHASING', submodule='INVOICE', documentType='INVOICE'`,
     inputSchema: { type: "object", properties: { documentTypeUuid: { type: "string" } }, required: ["documentTypeUuid"] },
     execute: async (input, authContext) => {
         try {

package/dist/tools/documents/document-types/get-merged-form-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-merged-form-metadata.js","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/get-merged-form-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAGlF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,8CAA8C;IAC3D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,kBAAkB,CAAC,EAAE;IAC9H,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,IAAI,UAAU,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACnJ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-merged-form-metadata.js","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/get-merged-form-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAGlF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE;;;;;;;;;;;;0EAY2D;IACxE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,kBAAkB,CAAC,EAAE;IAC9H,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,IAAI,UAAU,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACnJ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/documents/document-types/list-document-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-document-types.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/list-document-types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;qBAIZ,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"list-document-types.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/list-document-types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;qBAiBZ,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}

package/dist/tools/documents/document-types/list-document-types.js

@@ -2,7 +2,20 @@ import { logger } from "../../../utils/logger.js";
 import { listZudelloDocumentTypes } from "../../../services/zudello/index.js";
 export const zudelloListDocumentTypes = {
     name: "zudelloListDocumentTypes",
-    description: "List all document types",
+    description: `List document types (form layouts) in Zudello. Document types define the structure of forms like Purchase Orders, Invoices, Expenses, etc.
+
+Each document type has:
+- display: User-friendly name shown in UI
+- type/property: Internal identifier (usually UPPER_SNAKE_CASE)
+- module: Parent module (PURCHASING, EXPENSES, SALES, etc.)
+- submodule: Document category within module (INVOICE, ORDER, CLAIM, etc.)
+- settings: Contains fields, sections, and extensions configuration
+- isDefaultCreate/isDefaultPipeline: Whether this is the default type for new documents
+
+Filter by module and submodule to get document types for a specific area.
+Use includePaths to limit returned fields for lighter responses:
+- ["uuid", "payload.display", "payload.type", "payload.module", "payload.submodule"] for listings
+- Omit includePaths for full payload including settings`,
     inputSchema: { type: "object", properties: {} },
     execute: async (input, authContext) => {
         try {

package/dist/tools/documents/document-types/list-document-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-document-types.js","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/list-document-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,WAAW,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QAClG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YACnE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QAChF,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"list-document-types.js","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/list-document-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE;;;;;;;;;;;;;wDAayC;IACtD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,WAAW,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QAClG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YACnE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QAChF,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/documents/document-types/update-document-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-document-type.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/update-document-type.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;qBAIb,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"update-document-type.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/update-document-type.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;qBAmCb,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}

package/dist/tools/documents/document-types/update-document-type.js

@@ -2,7 +2,38 @@ import { logger } from "../../../utils/logger.js";
 import { updateZudelloDocumentType } from "../../../services/zudello/index.js";
 export const zudelloUpdateDocumentType = {
     name: "zudelloUpdateDocumentType",
-    description: "Update an existing document type",
+    description: `Update an existing document type in Zudello.
+
+IMPORTANT: Always use zudelloGetDocumentType first to retrieve the current configuration, then modify only what you need while preserving ALL other fields.
+
+## Workflow
+1. Get current document type: zudelloGetDocumentType(uuid)
+2. Copy the entire payload from the response
+3. Modify only the specific fields/sections/extensions you need to change
+4. Call this tool with the complete modified payload
+
+## Settings Structure
+The settings object contains:
+- fields[]: Field definitions with path, label, editor, section, visible, editable, validations
+- sections[]: Section definitions with key, label, order, visible, collapse, expandable
+- extensions[]: Active extensions with name and optional params
+- statuses: { create: "REVIEW", revert: "READY" } - status on create/revert
+- toolbar: Toolbar configuration (usually empty: {})
+
+## Field Definition Keys
+- path: Field path (e.g., "document_number", "lines.description")
+- label: Display label
+- editor: { type: "TEXT"|"NUMERIC"|"DATE"|"DD_SINGLE"|"BOOLEAN", ... }
+- section: { key: "HEADER"|"CONTACT"|"LINES", cols: 4, order: 0 }
+- visible/editable: Boolean flags
+- validations: [{ key: "required", level: "error", params: {} }]
+- renderer: { width: 100, break: { after: true }, align: "right" }
+
+## Section Definition Keys
+- key: Unique identifier (HEADER, CONTACT, ADDRESS_DELIVERY, LINES, TOTALS)
+- label: Display label
+- order: Display order (0 = first)
+- visible/collapse/expandable/editable/system: Boolean flags`,
     inputSchema: { type: "object", properties: { uuid: { type: "string" } }, required: ["uuid"] },
     execute: async (input, authContext) => {
         try {

package/dist/tools/documents/document-types/update-document-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-document-type.js","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/update-document-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAG/E,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,kCAAkC;IAC/C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;IACtG,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"update-document-type.js","sourceRoot":"","sources":["../../../../src/tools/documents/document-types/update-document-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAG/E,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DA+B8C;IAC3D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;IACtG,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/documents/export-templates/create-export-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-export-template.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/create-export-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,2BAA2B;;;;;;;qBAIf,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"create-export-template.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/create-export-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,2BAA2B;;;;;;;qBAsCf,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}

package/dist/tools/documents/export-templates/create-export-template.js

@@ -2,7 +2,41 @@ import { logger } from "../../../utils/logger.js";
 import { createZudelloExportTemplate } from "../../../services/zudello/index.js";
 export const zudelloCreateExportTemplate = {
     name: "zudelloCreateExportTemplate",
-    description: "Create a new export template",
+    description: `Create a new export template in Zudello.
+
+**IMPORTANT - Field Discovery:**
+Before creating a template, call zudelloGetFieldMetadata with:
+- modelName: The model (e.g., "Transaction", "Item")
+- section: "filters"
+- module: The target module (e.g., "PURCHASING")
+- submodule: The target submodule (e.g., "INVOICE")
+
+Use the 'path' values from the response for selected_fields.
+
+**Export Types:**
+- "csv": Structured data export with selected fields
+- "originals": Export original file attachments
+
+**Model Names by Module:**
+- PURCHASING/SALES/EXPENSES/LEDGER: Transaction
+- INVENTORY/CATALOGUE: Item
+- DIMENSIONS/ACCOUNT: Account
+- DIMENSIONS/LOCATION: Location
+- DIMENSIONS/COST_CENTRE: CostCentre
+- DIMENSIONS/PROJECT: Project
+- RELATIONSHIPS/SUPPLIER: Supplier
+- RELATIONSHIPS/CUSTOMER: Customer
+- BUDGETS/BUDGET: Budget
+
+**Filter Operators:**
+- exact: Exact match (status: "COMPLETE")
+- !exact: Not equal (status: !"DELETED")
+- in: Value in list (status__in: ["REVIEW", "APPROVAL"])
+- range: Between values (date_issued__range: ["2025-01-01", "2025-12-31"])
+- gt/lt/gte/lte: Numeric/date comparisons
+- icontains: Case-insensitive substring match
+- isnull: Null check (value: true/false)
+- date_on: Exact date match`,
     inputSchema: { type: "object", properties: {} },
     execute: async (input, authContext) => {
         try {

package/dist/tools/documents/export-templates/create-export-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-export-template.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/create-export-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAGjF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,8BAA8B;IAC3C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"create-export-template.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/create-export-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAGjF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAkCa;IAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/documents/export-templates/get-export-download-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-export-download-url.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/get-export-download-url.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;qBAIf,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"get-export-download-url.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/get-export-download-url.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;qBASf,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}

package/dist/tools/documents/export-templates/get-export-download-url.js

@@ -2,7 +2,12 @@ import { logger } from "../../../utils/logger.js";
 import { getZudelloExportDownloadUrl } from "../../../services/zudello/index.js";
 export const zudelloGetExportDownloadUrl = {
     name: "zudelloGetExportDownloadUrl",
-    description: "Get download URL for a completed export",
+    description: `Get the download URL for a completed export.
+
+Returns a presigned S3 URL that can be used to download the export file.
+The URL is temporary and will expire after a period of time.
+
+Use zudelloListExports first to get the export UUID.`,
     inputSchema: { type: "object", properties: { exportUuid: { type: "string" } }, required: ["exportUuid"] },
     execute: async (input, authContext) => {
         try {

package/dist/tools/documents/export-templates/get-export-download-url.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-export-download-url.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/get-export-download-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAGjF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,yCAAyC;IACtD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE;IAClH,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAClF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-export-download-url.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/get-export-download-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAGjF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE;;;;;qDAKsC;IACnD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE;IAClH,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAClF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/documents/export-templates/get-export-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-export-template.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/get-export-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;qBAYZ;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;CAkBlE,CAAC"}
+{"version":3,"file":"get-export-template.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/get-export-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;qBAaZ;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;CAkBlE,CAAC"}

package/dist/tools/documents/export-templates/get-export-template.js

@@ -2,9 +2,10 @@ import { logger } from "../../../utils/logger.js";
 import { getZudelloExportTemplate } from "../../../services/zudello/index.js";
 export const zudelloGetExportTemplate = {
     name: "zudelloGetExportTemplate",
-    description: `Get details for a specific export template.
+    description: `Get details of a specific export template by its UUID.
 
-Returns complete export template configuration.`,
+Returns the full template configuration including fields, filters, and module/submodule scope.
+Use zudelloListExportTemplates first to find the UUID.`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/documents/export-templates/get-export-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-export-template.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/get-export-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE;;gDAEiC;IAC9C,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SACrE;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,KAAuB,EAAE,WAAwB,EAAE,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAEzE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,+BAA+B,CAAC,CAAC;YACrE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,IAAI;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACtE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-export-template.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/get-export-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE;;;uDAGwC;IACrD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SACrE;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,KAAuB,EAAE,WAAwB,EAAE,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAEzE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,+BAA+B,CAAC,CAAC;YACrE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,IAAI;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACtE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/documents/export-templates/list-export-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-export-templates.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/list-export-templates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,0BAA0B;;;;;;;qBASd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,WAAW;;;;;;;;;;;CAmBzE,CAAC"}
+{"version":3,"file":"list-export-templates.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/list-export-templates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,0BAA0B;;;;;;;qBAmBd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,WAAW;;;;;;;;;;;CAmBzE,CAAC"}

package/dist/tools/documents/export-templates/list-export-templates.js

@@ -2,9 +2,19 @@ import { logger } from "../../../utils/logger.js";
 import { listZudelloExportTemplates } from "../../../services/zudello/index.js";
 export const zudelloListExportTemplates = {
     name: "zudelloListExportTemplates",
-    description: `List all export templates.
+    description: `List all export templates in Zudello.
 
-Returns export template definitions including names, formats, and configuration.`,
+Export templates define reusable CSV export configurations for any module/submodule combination.
+
+Each template includes:
+- name: Display name for the template
+- module/submodule: Document type scope (e.g., PURCHASING/INVOICE)
+- model_name: Data model (Transaction, Item, Account, etc.)
+- export_type: "csv" for data export, "originals" for file attachments
+- selected_fields: Fields to include in export (use dot notation for related fields)
+- raw_filter: Optional filters to apply during export
+
+Use this to discover existing templates before creating new ones.`,
     inputSchema: {
         type: "object",
         properties: {},

package/dist/tools/documents/export-templates/list-export-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-export-templates.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/list-export-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGhF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE;;iFAEkE;IAC/E,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;KACf;IACD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAE,WAAwB,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACpD,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC;YAE/D,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,iCAAiC,CAAC,CAAC;YACvE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE;gBAC9B,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"list-export-templates.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/list-export-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGhF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE;;;;;;;;;;;;kEAYmD;IAChE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;KACf;IACD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAE,WAAwB,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACpD,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC;YAE/D,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,iCAAiC,CAAC,CAAC;YACvE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE;gBAC9B,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/documents/export-templates/list-exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-exports.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/list-exports.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;;qBAIN,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"list-exports.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/list-exports.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;;qBASN,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}

package/dist/tools/documents/export-templates/list-exports.js

@@ -2,7 +2,12 @@ import { logger } from "../../../utils/logger.js";
 import { listZudelloExports } from "../../../services/zudello/index.js";
 export const zudelloListExports = {
     name: "zudelloListExports",
-    description: "List all exports",
+    description: `List data exports that have been run.
+
+Returns recent exports with their status, template name, and download information.
+Use this after running an export to find its UUID, then call zudelloGetExportDownloadUrl.
+
+Results are ordered by creation date (newest first).`,
     inputSchema: { type: "object", properties: {} },
     execute: async (input, authContext) => {
         try {

package/dist/tools/documents/export-templates/list-exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-exports.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/list-exports.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,kBAAkB;IAC/B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;YACvD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"list-exports.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/list-exports.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;;;;;qDAKsC;IACnD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;YACvD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/documents/export-templates/run-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-export.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/run-export.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;qBAIJ,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"run-export.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/run-export.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;qBAuBJ,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}

package/dist/tools/documents/export-templates/run-export.js

@@ -2,7 +2,26 @@ import { logger } from "../../../utils/logger.js";
 import { runZudelloExport } from "../../../services/zudello/index.js";
 export const zudelloRunExport = {
     name: "zudelloRunExport",
-    description: "Run an export using a template",
+    description: `Run a data export using an existing template.
+
+This triggers an async export job. The export will be created in the background.
+After running, use zudelloListExports to check status and get the export UUID.
+Then use zudelloGetExportDownloadUrl to get the download link.
+
+**Required Parameters:**
+- templateName: Name of the export template to use (must match exactly)
+- userUuid: UUID of the user running the export (use context user UUID)
+
+**Export Request:**
+- model: Must match the template's model_name (e.g., "Transaction")
+- select: Fields to export (usually matches template's selected_fields)
+- filter: Must include module and submodule at minimum
+
+**Workflow:**
+1. Run export with this tool
+2. Wait a few seconds for processing
+3. Call zudelloListExports to find the new export
+4. Call zudelloGetExportDownloadUrl with the export UUID`,
     inputSchema: { type: "object", properties: { templateUuid: { type: "string" } }, required: ["templateUuid"] },
     execute: async (input, authContext) => {
         try {

package/dist/tools/documents/export-templates/run-export.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-export.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/run-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAGtE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,gCAAgC;IAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,cAAc,CAAC,EAAE;IACtH,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YAC5H,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC9D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"run-export.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/run-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAGtE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;yDAmB0C;IACvD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,cAAc,CAAC,EAAE;IACtH,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YAC5H,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC9D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/documents/export-templates/update-export-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-export-template.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/update-export-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;qBAIf,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"update-export-template.d.ts","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/update-export-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;qBAYf,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}

package/dist/tools/documents/export-templates/update-export-template.js

@@ -2,7 +2,15 @@ import { logger } from "../../../utils/logger.js";
 import { updateZudelloExportTemplate } from "../../../services/zudello/index.js";
 export const zudelloUpdateExportTemplate = {
     name: "zudelloUpdateExportTemplate",
-    description: "Update an existing export template",
+    description: `Update an existing export template.
+
+**IMPORTANT - Field Discovery:**
+Before updating, call zudelloGetFieldMetadata to verify field paths are valid for the module/submodule.
+
+Provide the template UUID and the complete updated configuration.
+All fields will be replaced with the new values.
+
+First use zudelloGetExportTemplate to get current values, then modify as needed.`,
     inputSchema: { type: "object", properties: { uuid: { type: "string" } }, required: ["uuid"] },
     execute: async (input, authContext) => {
         try {

package/dist/tools/documents/export-templates/update-export-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-export-template.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/update-export-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAGjF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,oCAAoC;IACjD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;IACtG,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACnF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"update-export-template.js","sourceRoot":"","sources":["../../../../src/tools/documents/export-templates/update-export-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAGjF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE;;;;;;;;iFAQkE;IAC/E,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;IACtG,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACnF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/history/get-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-history.d.ts","sourceRoot":"","sources":["../../../src/tools/history/get-history.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;qBAWL;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;CAYlF,CAAC"}
+{"version":3,"file":"get-history.d.ts","sourceRoot":"","sources":["../../../src/tools/history/get-history.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;qBAmBL;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;CAYlF,CAAC"}

package/dist/tools/history/get-history.js

@@ -2,7 +2,15 @@ import { logger } from "../../utils/logger.js";
 import { getZudelloHistory } from "../../services/zudello/resources.js";
 export const zudelloGetHistory = {
     name: "zudelloGetHistory",
-    description: "View audit trail and change history for a resource",
+    description: `Get the audit/change history for a specific Zudello resource.
+
+Returns a list of events showing what changed, when, and by whom. Useful for:
+- Tracking document status changes
+- Understanding who made modifications
+- Auditing approval workflows
+- Investigating issues
+
+Valid models: Transaction, Item, Customer, Supplier, Employee, Budget, Contract, Account, Department, Location`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/history/get-history.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-history.js","sourceRoot":"","sources":["../../../src/tools/history/get-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAGxE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,oDAAoD;IACjE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACtD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;SACrD;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,KAAuC,EAAE,WAAwB,EAAE,EAAE;QACnF,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC,CAAC,uCAAuC;YAChF,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACzE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAC;YAClF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;YAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,KAAc,CAAC,CAAC;YAClG,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-history.js","sourceRoot":"","sources":["../../../src/tools/history/get-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAGxE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;+GAQgG;IAC7G,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACtD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;SACrD;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,KAAuC,EAAE,WAAwB,EAAE,EAAE;QACnF,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC,CAAC,uCAAuC;YAChF,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACzE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAC;YAClF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;YAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,KAAc,CAAC,CAAC;YAClG,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/inboxes/create-inbox-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-inbox-template.d.ts","sourceRoot":"","sources":["../../../src/tools/inboxes/create-inbox-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,0BAA0B;;;;;;;;;;;qBAOd,GAAG,eAAe,WAAW;;;;;;;;;CAarD,CAAC"}
+{"version":3,"file":"create-inbox-template.d.ts","sourceRoot":"","sources":["../../../src/tools/inboxes/create-inbox-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,0BAA0B;;;;;;;;;;;qBAgCd,GAAG,eAAe,WAAW;;;;;;;;;CAarD,CAAC"}

package/dist/tools/inboxes/create-inbox-template.js

@@ -2,7 +2,32 @@ import { logger } from "../../utils/logger.js";
 import { createInboxTemplate } from "../../services/zudello/index.js";
 export const zudelloCreateInboxTemplate = {
     name: "zudelloCreateInboxTemplate",
-    description: "Create email template",
+    description: `Create a new inbox template (email template) for outbound communications.
+
+Inbox templates define the email structure sent from Zudello inboxes, including
+subject line and HTML body with support for dynamic field placeholders.
+
+**REQUIRED INPUT:**
+- name: Display name for the template
+- section: Module section (e.g., "PURCHASING", "SALES", "EXPENSES")
+- subject: Email subject line (can include {{placeholders}})
+- body: HTML email body content (can include {{placeholders}})
+
+**PLACEHOLDER SYNTAX:**
+Use {{field_path}} for dynamic values. Common placeholders:
+- {{document_number}} - Document/invoice number
+- {{company_name}} - Company name
+- {{company_email}} - Company email address
+- {{company_tax}} - Company tax/ABN number
+- {{delivery_address.state}} - Delivery state
+- {{delivery_address.country}} - Delivery country
+- {{supplier_name}} - Supplier name
+- {{total_amount}} - Total amount
+
+**USE CASES:**
+- Create email templates for different document types
+- Set up department-specific email communications
+- Configure automated notifications with dynamic content`,
     inputSchema: {
         type: "object",
         properties: { name: { type: "string" } }

package/dist/tools/inboxes/create-inbox-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-inbox-template.js","sourceRoot":"","sources":["../../../src/tools/inboxes/create-inbox-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAGtE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,uBAAuB;IACpC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;KACzC;IACD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC/D,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,kBAAkB,CAAC,CAAC;YAC7E,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,IAAI;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACxE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"create-inbox-template.js","sourceRoot":"","sources":["../../../src/tools/inboxes/create-inbox-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAGtE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;yDAyB0C;IACvD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;KACzC;IACD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC/D,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,kBAAkB,CAAC,CAAC;YAC7E,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,IAAI;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACxE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/inboxes/create-inbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-inbox.d.ts","sourceRoot":"","sources":["../../../src/tools/inboxes/create-inbox.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;qBAON,GAAG,eAAe,WAAW;;;;;;;;;CAarD,CAAC"}
+{"version":3,"file":"create-inbox.d.ts","sourceRoot":"","sources":["../../../src/tools/inboxes/create-inbox.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;qBA4BN,GAAG,eAAe,WAAW;;;;;;;;;CAarD,CAAC"}

package/dist/tools/inboxes/create-inbox.js

@@ -2,7 +2,28 @@ import { logger } from "../../utils/logger.js";
 import { createInbox } from "../../services/zudello/index.js";
 export const zudelloCreateInbox = {
     name: "zudelloCreateInbox",
-    description: "Create new email inbox",
+    description: `Create a new email inbox for receiving documents.
+
+Creates an inbox that can receive documents via email forwarding.
+Emails sent to {mailbox}@{inbound_domain} will be processed.
+
+**REQUIRED INPUT:**
+- name: Display name for the inbox
+- mailbox: Email prefix/mailbox name (used as part of email address)
+- resourceModule: Target module for documents (e.g., "PURCHASING", "SALES")
+
+**OPTIONAL INPUT:**
+- subsidiaryUuid: UUID of subsidiary to associate
+- locationUuid: UUID of location to associate
+
+**EMAIL ADDRESS FORMAT:**
+The inbox will receive emails at: {mailbox}@{inbound_domain}
+Use zudelloGetInboundDomain to get the domain.
+
+**USE CASES:**
+- Create dedicated inboxes for different document types
+- Set up regional inboxes for local suppliers
+- Create inboxes for specific departments or cost centers`,
     inputSchema: {
         type: "object",
         properties: { name: { type: "string" }, email: { type: "string" } }

package/dist/tools/inboxes/create-inbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-inbox.js","sourceRoot":"","sources":["../../../src/tools/inboxes/create-inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAG9D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,wBAAwB;IACrC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;KACpE;IACD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACvD,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,kBAAkB,CAAC,CAAC;YAC7E,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,0BAA0B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAChE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"create-inbox.js","sourceRoot":"","sources":["../../../src/tools/inboxes/create-inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAG9D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;0DAqB2C;IACxD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;KACpE;IACD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACvD,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,kBAAkB,CAAC,CAAC;YAC7E,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,0BAA0B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAChE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/inboxes/fetch-inbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-inbox.d.ts","sourceRoot":"","sources":["../../../src/tools/inboxes/fetch-inbox.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;qBAOL,GAAG,eAAe,WAAW;;;;;;;;;CAarD,CAAC"}
+{"version":3,"file":"fetch-inbox.d.ts","sourceRoot":"","sources":["../../../src/tools/inboxes/fetch-inbox.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;qBAoBL,GAAG,eAAe,WAAW;;;;;;;;;CAarD,CAAC"}

package/dist/tools/inboxes/fetch-inbox.js

@@ -2,7 +2,20 @@ import { logger } from "../../utils/logger.js";
 import { fetchInbox } from "../../services/zudello/index.js";
 export const zudelloFetchInbox = {
     name: "zudelloFetchInbox",
-    description: "Get single inbox details",
+    description: `Fetch detailed information about a specific inbox.
+
+Returns full inbox details including associated template configuration.
+
+**REQUIRED INPUT:**
+- inboxUuid: The UUID of the inbox to fetch
+
+**RESPONSE STRUCTURE:**
+Returns complete inbox object with nested template details.
+
+**USE CASES:**
+- Get inbox email address for sharing
+- Verify inbox template association before processing
+- Check inbox activity status`,
     inputSchema: {
         type: "object",
         properties: { uuid: { type: "string", description: "Inbox UUID" } },

package/dist/tools/inboxes/fetch-inbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-inbox.js","sourceRoot":"","sources":["../../../src/tools/inboxes/fetch-inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAG7D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,0BAA0B;IACvC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE;KACpE;IACD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,kBAAkB,CAAC,CAAC;YAC7E,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,yBAAyB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC/D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"fetch-inbox.js","sourceRoot":"","sources":["../../../src/tools/inboxes/fetch-inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAG7D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;;;;;8BAae;IAC5B,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE;KACpE;IACD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,kBAAkB,CAAC,CAAC;YAC7E,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,yBAAyB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC/D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/inboxes/get-inbound-domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-inbound-domain.d.ts","sourceRoot":"","sources":["../../../src/tools/inboxes/get-inbound-domain.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,uBAAuB;;;;;;;qBAOX,GAAG,eAAe,WAAW;;;;;;;;;;;CAarD,CAAC"}
+{"version":3,"file":"get-inbound-domain.d.ts","sourceRoot":"","sources":["../../../src/tools/inboxes/get-inbound-domain.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,uBAAuB;;;;;;;qBAoBX,GAAG,eAAe,WAAW;;;;;;;;;;;CAarD,CAAC"}