@zudello/mcp 1.1.2

package/dist/tools/language/get-language-placeholders.d.ts

@@ -0,0 +1,27 @@
+import type { AuthContext } from "../../context/auth.js";
+export declare const zudelloGetLanguagePlaceholders: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    execute: (input: Record<string, unknown>, authContext: AuthContext) => Promise<{
+        success: boolean;
+        resourceUuid: string | undefined;
+        lang: Record<string, import("../../services/zudello/types.js").LanguagePlaceholderEntry>;
+        entityCount: number;
+        version: string | undefined;
+        updatedAt: string | undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        lang: null;
+        resourceUuid?: undefined;
+        entityCount?: undefined;
+        version?: undefined;
+        updatedAt?: undefined;
+    }>;
+};
+//# sourceMappingURL=get-language-placeholders.d.ts.map

package/dist/tools/language/get-language-placeholders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-language-placeholders.d.ts","sourceRoot":"","sources":["../../../src/tools/language/get-language-placeholders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,8BAA8B;;;;;;;qBA4ClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,WAAW;;;;;;;;;;;;;;;;;CAoBzE,CAAC"}

package/dist/tools/language/get-language-placeholders.js

@@ -0,0 +1,70 @@
+import { logger } from "../../utils/logger.js";
+import { getZudelloLanguagePlaceholders } from "../../services/zudello/index.js";
+export const zudelloGetLanguagePlaceholders = {
+    name: "zudelloGetLanguagePlaceholders",
+    description: `Get all language placeholders configured for the team.
+
+Language placeholders allow customizing entity labels across the Zudello UI
+to match your organization's terminology (e.g., "Vendor" vs "Supplier").
+
+**RESPONSE STRUCTURE:**
+Returns a resource containing:
+- uuid: Resource UUID (needed for updates)
+- payload.lang: Object mapping entity keys to their labels
+  - Each entry has: singular, plural, and linkedModel
+
+**EXAMPLE RESPONSE:**
+{
+  "uuid": "f0e4c2f6-1234-5678-90ab-cdef12345678",
+  "payload": {
+    "lang": {
+      "supplier": { "singular": "Vendor", "plural": "Vendors", "linkedModel": "Supplier" },
+      "account": { "singular": "Account", "plural": "Accounts", "linkedModel": "Account" },
+      "costCenter": { "singular": "Department", "plural": "Departments", "linkedModel": "CostCenter" },
+      "project": { "singular": "Project", "plural": "Projects", "linkedModel": "Project" }
+    }
+  }
+}
+
+**COMMON ENTITY KEYS:**
+- supplier: Supplier/Vendor terminology
+- customer: Customer terminology
+- account: GL Account terminology
+- costCenter: Cost Center/Department terminology
+- project: Project terminology
+- contract: Contract terminology
+- location: Location/Site terminology
+- subsidiary: Subsidiary/Entity terminology
+- warehouse: Warehouse terminology
+- unitOfMeasure: Unit of Measure terminology
+
+**USE CASES:**
+- Review current terminology customizations
+- Audit consistency of UI labels before changes
+- Get the resource UUID needed for update operations
+- Onboard new users by explaining custom terminology`,
+    inputSchema: { type: "object", properties: {} },
+    execute: async (input, authContext) => {
+        try {
+            logger.debug("zudelloGetLanguagePlaceholders executed");
+            const response = await getZudelloLanguagePlaceholders(authContext);
+            if (!response.success)
+                throw new Error(response.error || "Failed to get language placeholders");
+            const resource = response.data;
+            const lang = resource?.payload?.lang || {};
+            return {
+                success: true,
+                resourceUuid: resource?.uuid,
+                lang,
+                entityCount: Object.keys(lang).length,
+                version: resource?.version,
+                updatedAt: resource?.updated_at,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloGetLanguagePlaceholders error", {}, error);
+            return { success: false, error: error.message, lang: null };
+        }
+    },
+};
+//# sourceMappingURL=get-language-placeholders.js.map

package/dist/tools/language/get-language-placeholders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-language-placeholders.js","sourceRoot":"","sources":["../../../src/tools/language/get-language-placeholders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AAGjF,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qDAwCsC;IACnD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAE,WAAwB,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,MAAM,8BAA8B,CAAC,WAAW,CAAC,CAAC;YACnE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,qCAAqC,CAAC,CAAC;YAChG,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;YAC/B,MAAM,IAAI,GAAG,QAAQ,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;YAC3C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,QAAQ,EAAE,IAAI;gBAC5B,IAAI;gBACJ,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM;gBACrC,OAAO,EAAE,QAAQ,EAAE,OAAO;gBAC1B,SAAS,EAAE,QAAQ,EAAE,UAAU;aAChC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/language/index.d.ts

@@ -0,0 +1,3 @@
+export { zudelloGetLanguagePlaceholders } from "./get-language-placeholders.js";
+export { zudelloUpdateLanguagePlaceholders } from "./update-language-placeholders.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/language/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/language/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/tools/language/index.js

@@ -0,0 +1,3 @@
+export { zudelloGetLanguagePlaceholders } from "./get-language-placeholders.js";
+export { zudelloUpdateLanguagePlaceholders } from "./update-language-placeholders.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/language/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/language/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/tools/language/update-language-placeholders.d.ts

@@ -0,0 +1,39 @@
+import type { AuthContext } from "../../context/auth.js";
+import type { LanguagePlaceholderEntry } from "../../services/zudello/types.js";
+export declare const zudelloUpdateLanguagePlaceholders: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            resourceUuid: {
+                type: string;
+                description: string;
+            };
+            lang: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        resourceUuid: string;
+        lang: Record<string, LanguagePlaceholderEntry>;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        resourceUuid: string | undefined;
+        lang: Record<string, LanguagePlaceholderEntry> | undefined;
+        version: string | undefined;
+        message: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        lang: null;
+        resourceUuid?: undefined;
+        version?: undefined;
+        message?: undefined;
+    }>;
+};
+//# sourceMappingURL=update-language-placeholders.d.ts.map

package/dist/tools/language/update-language-placeholders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-language-placeholders.d.ts","sourceRoot":"","sources":["../../../src/tools/language/update-language-placeholders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAEhF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;qBA+CnC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;KAAE,eAClE,WAAW;;;;;;;;;;;;;;;CAsB3B,CAAC"}

package/dist/tools/language/update-language-placeholders.js

@@ -0,0 +1,73 @@
+import { logger } from "../../utils/logger.js";
+import { updateZudelloLanguagePlaceholders } from "../../services/zudello/index.js";
+export const zudelloUpdateLanguagePlaceholders = {
+    name: "zudelloUpdateLanguagePlaceholders",
+    description: `Update language placeholders for the team.
+
+Allows customizing UI terminology to match your organization's language preferences.
+Each entity label requires singular and plural forms, plus the linkedModel reference.
+
+**WORKFLOW:**
+1. First call zudelloGetLanguagePlaceholders to get current values and the resourceUuid
+2. Modify the lang object as needed
+3. Call this tool with the resourceUuid and complete lang object
+
+**IMPORTANT:** You must provide the COMPLETE lang object with ALL entities.
+This is a PUT operation that replaces the entire language configuration.
+
+**REQUIRED INPUT:**
+- resourceUuid: The UUID from getLanguagePlaceholders response
+- lang: Object mapping entity keys to their label configuration
+
+**EXAMPLE REQUEST:**
+{
+  "resourceUuid": "f0e4c2f6-1234-5678-90ab-cdef12345678",
+  "lang": {
+    "supplier": { "singular": "Vendor", "plural": "Vendors", "linkedModel": "Supplier" },
+    "account": { "singular": "GL Account", "plural": "GL Accounts", "linkedModel": "Account" },
+    "costCenter": { "singular": "Department", "plural": "Departments", "linkedModel": "CostCenter" },
+    "project": { "singular": "Job", "plural": "Jobs", "linkedModel": "Project" }
+  }
+}
+
+**USE CASES:**
+- Align Zudello terminology with ERP system labels
+- Update terminology after organizational rebrand
+- Customize for industry-specific language (e.g., "Job" instead of "Project")
+- Support regional terminology preferences`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            resourceUuid: { type: "string", description: "UUID of the language placeholders resource" },
+            lang: {
+                type: "object",
+                description: "Complete object mapping entity keys to their label configuration"
+            }
+        },
+        required: ["resourceUuid", "lang"]
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.debug("zudelloUpdateLanguagePlaceholders executed", {
+                resourceUuid: input.resourceUuid,
+                entityCount: Object.keys(input.lang).length
+            });
+            const response = await updateZudelloLanguagePlaceholders(authContext, input.resourceUuid, input.lang);
+            if (!response.success)
+                throw new Error(response.error || "Failed to update language placeholders");
+            const entityCount = Object.keys(input.lang).length;
+            return {
+                success: true,
+                resourceUuid: response.data?.uuid,
+                lang: response.data?.payload?.lang,
+                version: response.data?.version,
+                message: `Updated ${entityCount} language placeholder(s) successfully`
+            };
+        }
+        catch (error) {
+            logger.error("zudelloUpdateLanguagePlaceholders error", {}, error);
+            return { success: false, error: error.message, lang: null };
+        }
+    }
+};
+//# sourceMappingURL=update-language-placeholders.js.map

package/dist/tools/language/update-language-placeholders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-language-placeholders.js","sourceRoot":"","sources":["../../../src/tools/language/update-language-placeholders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AAIpF,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAgC4B;IACzC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;YAC3F,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kEAAkE;aAChF;SACF;QACD,QAAQ,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC;KACnC;IACD,OAAO,EAAE,KAAK,EACZ,KAA+E,EAC/E,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,4CAA4C,EAAE;gBACzD,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;aAC5C,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,iCAAiC,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACtG,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wCAAwC,CAAC,CAAC;YACnG,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YACnD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI;gBACjC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI;gBAClC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO;gBAC/B,OAAO,EAAE,WAAW,WAAW,uCAAuC;aACvE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC5E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/models/get-field-metadata.d.ts

@@ -0,0 +1,49 @@
+import type { AuthContext } from "../../context/auth.js";
+/**
+ * Get field metadata for a specific model and section
+ */
+export declare const zudelloGetFieldMetadata: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            modelName: {
+                type: string;
+                description: string;
+            };
+            section: {
+                type: string;
+                description: string;
+            };
+            module: {
+                type: string;
+                description: string;
+            };
+            submodule: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        modelName: string;
+        section: string;
+        module?: string;
+        submodule?: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        modelName: string;
+        section: string;
+        data: Record<string, unknown> | undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        modelName: string;
+        section: string;
+        data: null;
+    }>;
+};
+//# sourceMappingURL=get-field-metadata.d.ts.map

package/dist/tools/models/get-field-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-field-metadata.d.ts","sourceRoot":"","sources":["../../../src/tools/models/get-field-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;qBAyCzB;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,eACY,WAAW;;;;;;;;;;;;;CA2C3B,CAAC"}

package/dist/tools/models/get-field-metadata.js

@@ -0,0 +1,77 @@
+import { logger } from "../../utils/logger.js";
+import { getZudelloFieldMetadata } from "../../services/zudello/resources.js";
+/**
+ * Get field metadata for a specific model and section
+ */
+export const zudelloGetFieldMetadata = {
+    name: "zudelloGetFieldMetadata",
+    description: `Get valid field names for a model/module/submodule combination in Zudello.
+
+IMPORTANT: Use this tool with section='filters' BEFORE using zudelloSearch with custom select fields.
+The response contains a 'fields' array where each field has a 'path' property - use these paths in your search 'select' array.
+
+Example: To find valid fields for Purchase Invoices:
+  {modelName: 'Transaction', section: 'filters', module: 'PURCHASING', submodule: 'INVOICE'}
+
+The 'path' values (e.g., 'document_number', 'supplier__trading_name', 'lines__description') can be used directly in zudelloSearch select.
+
+Valid module/submodule combinations:
+- PURCHASING: CREDIT, INVOICE, ORDER, QUOTE, REQUISITION, RETURN, STATEMENT
+- SALES: CREDIT, INVOICE, ORDER, QUOTE, REMITTANCE
+- EXPENSES: CLAIM, EXPENSE, MILEAGE, PAYMENT, REFUND
+- INVENTORY: CATALOGUE, RECEIPT
+- RELATIONSHIPS: CUSTOMER, SUPPLIER, EMPLOYEE`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            modelName: {
+                type: "string",
+                description: "The model name to get field metadata for (e.g., 'Transaction', 'Customer')",
+            },
+            section: {
+                type: "string",
+                description: "The section for field metadata. Use 'filters' to get fields valid for search select/filter",
+            },
+            module: {
+                type: "string",
+                description: "Optional module filter: BUDGETS, CONTRACTS, DIMENSIONS, EXPENSES, INVENTORY, PURCHASING, RELATIONSHIPS, SALES",
+            },
+            submodule: {
+                type: "string",
+                description: "Optional submodule filter - depends on module. Examples: INVOICE, ORDER, QUOTE for PURCHASING/SALES; CLAIM, EXPENSE for EXPENSES",
+            },
+        },
+        required: ["modelName", "section"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloGetFieldMetadata executed", {
+                modelName: input.modelName,
+                section: input.section,
+                module: input.module,
+                submodule: input.submodule,
+            });
+            const response = await getZudelloFieldMetadata(input.modelName, input.section, authContext, input.module, input.submodule);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to get field metadata");
+            }
+            return {
+                success: true,
+                modelName: input.modelName,
+                section: input.section,
+                data: response.data,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloGetFieldMetadata error", { modelName: input.modelName, section: input.section }, error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+                modelName: input.modelName,
+                section: input.section,
+                data: null,
+            };
+        }
+    },
+};
+//# sourceMappingURL=get-field-metadata.js.map

package/dist/tools/models/get-field-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-field-metadata.js","sourceRoot":"","sources":["../../../src/tools/models/get-field-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAG9E;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE;;;;;;;;;;;;;;;8CAe+B;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4EAA4E;aAC1F;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4FAA4F;aAC1G;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+GAA+G;aAC7H;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kIAAkI;aAChJ;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;KACnC;IACD,OAAO,EAAE,KAAK,EACZ,KAKC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;gBAC9C,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAC5C,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,OAAO,EACb,WAAW,EACX,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,SAAS,CAChB,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,8BAA8B,CAAC,CAAC;YACpE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,+BAA+B,EAC/B,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EACtD,KAAc,CACf,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,IAAI;aACX,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/models/get-model-metadata.d.ts

@@ -0,0 +1,32 @@
+import type { AuthContext } from "../../context/auth.js";
+/**
+ * Get detailed metadata information for a specific Zudello model
+ */
+export declare const zudelloGetModelMetadata: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            modelName: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        modelName: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        modelName: string;
+        data: Record<string, unknown> | undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        modelName: string;
+        data: null;
+    }>;
+};
+//# sourceMappingURL=get-model-metadata.d.ts.map

package/dist/tools/models/get-model-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-model-metadata.d.ts","sourceRoot":"","sources":["../../../src/tools/models/get-model-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;qBAgBX;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;CAyBvE,CAAC"}

package/dist/tools/models/get-model-metadata.js

@@ -0,0 +1,46 @@
+import { logger } from "../../utils/logger.js";
+import { getZudelloModelMetadata } from "../../services/zudello/resources.js";
+/**
+ * Get detailed metadata information for a specific Zudello model
+ */
+export const zudelloGetModelMetadata = {
+    name: "zudelloGetModelMetadata",
+    description: `Get detailed metadata information for a specific Zudello model including available fields, types, and relationships.
+
+Essential for understanding model structure before building search queries.
+Valid models include: Transaction, Item, Customer, Supplier, Employee, Budget, Contract, Account, Department, Location, and others.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            modelName: {
+                type: "string",
+                description: "The model name to get metadata for (e.g., 'Transaction', 'Customer', 'Supplier')",
+            },
+        },
+        required: ["modelName"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloGetModelMetadata executed", { modelName: input.modelName });
+            const response = await getZudelloModelMetadata(input.modelName, authContext);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to get model metadata");
+            }
+            return {
+                success: true,
+                modelName: input.modelName,
+                data: response.data,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloGetModelMetadata error", { modelName: input.modelName }, error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+                modelName: input.modelName,
+                data: null,
+            };
+        }
+    },
+};
+//# sourceMappingURL=get-model-metadata.js.map

package/dist/tools/models/get-model-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-model-metadata.js","sourceRoot":"","sources":["../../../src/tools/models/get-model-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAG9E;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE;;;oIAGqH;IAClI,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kFAAkF;aAChG;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,OAAO,EAAE,KAAK,EAAE,KAA4B,EAAE,WAAwB,EAAE,EAAE;QACxE,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YAEhF,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAE7E,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,8BAA8B,CAAC,CAAC;YACpE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,KAAc,CAAC,CAAC;YAC9F,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,IAAI;aACX,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/models/get-model-relations.d.ts

@@ -0,0 +1,32 @@
+import type { AuthContext } from "../../context/auth.js";
+/**
+ * Get relationship information for a specific Zudello model
+ */
+export declare const zudelloGetModelRelations: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            modelName: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        modelName: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        modelName: string;
+        data: Record<string, unknown> | undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        modelName: string;
+        data: null;
+    }>;
+};
+//# sourceMappingURL=get-model-relations.d.ts.map

package/dist/tools/models/get-model-relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-model-relations.d.ts","sourceRoot":"","sources":["../../../src/tools/models/get-model-relations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;qBAiBZ;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;CAyBvE,CAAC"}

package/dist/tools/models/get-model-relations.js

@@ -0,0 +1,47 @@
+import { logger } from "../../utils/logger.js";
+import { getZudelloModelRelations } from "../../services/zudello/resources.js";
+/**
+ * Get relationship information for a specific Zudello model
+ */
+export const zudelloGetModelRelations = {
+    name: "zudelloGetModelRelations",
+    description: `Get relationship information for a specific Zudello model including how it connects to other models.
+
+Useful for understanding which related data can be included in queries using dot notation.
+For example, Transaction might have relations to Supplier, Customer, lines, etc.
+Valid models include: Transaction, Item, Customer, Supplier, Employee, and others.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            modelName: {
+                type: "string",
+                description: "The model name to get relations for (e.g., 'Transaction', 'Customer', 'Supplier')",
+            },
+        },
+        required: ["modelName"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloGetModelRelations executed", { modelName: input.modelName });
+            const response = await getZudelloModelRelations(input.modelName, authContext);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to get model relations");
+            }
+            return {
+                success: true,
+                modelName: input.modelName,
+                data: response.data,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloGetModelRelations error", { modelName: input.modelName }, error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+                modelName: input.modelName,
+                data: null,
+            };
+        }
+    },
+};
+//# sourceMappingURL=get-model-relations.js.map

package/dist/tools/models/get-model-relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-model-relations.js","sourceRoot":"","sources":["../../../src/tools/models/get-model-relations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAG/E;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE;;;;mFAIoE;IACjF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mFAAmF;aACjG;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,OAAO,EAAE,KAAK,EAAE,KAA4B,EAAE,WAAwB,EAAE,EAAE;QACxE,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YAEjF,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAE9E,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,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,KAAc,CAAC,CAAC;YAC/F,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,IAAI;aACX,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/models/get-model-schema.d.ts

@@ -0,0 +1,32 @@
+import type { AuthContext } from "../../context/auth.js";
+/**
+ * Get detailed schema information for a specific Zudello model
+ */
+export declare const zudelloGetModelSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            modelName: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        modelName: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        modelName: string;
+        data: Record<string, unknown> | undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        modelName: string;
+        data: null;
+    }>;
+};
+//# sourceMappingURL=get-model-schema.d.ts.map

package/dist/tools/models/get-model-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-model-schema.d.ts","sourceRoot":"","sources":["../../../src/tools/models/get-model-schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;qBAgBT;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;CAyBvE,CAAC"}

package/dist/tools/models/get-model-schema.js

@@ -0,0 +1,46 @@
+import { logger } from "../../utils/logger.js";
+import { getZudelloModelSchema } from "../../services/zudello/resources.js";
+/**
+ * Get detailed schema information for a specific Zudello model
+ */
+export const zudelloGetModelSchema = {
+    name: "zudelloGetModelSchema",
+    description: `Get detailed schema information for a specific Zudello model including field definitions and data structure.
+
+Essential for understanding model structure and validation rules.
+Valid models include: Transaction, Item, Customer, Supplier, Employee, Budget, Contract, and others.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            modelName: {
+                type: "string",
+                description: "The model name to get schema for (e.g., 'Transaction', 'Customer', 'Supplier')",
+            },
+        },
+        required: ["modelName"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloGetModelSchema executed", { modelName: input.modelName });
+            const response = await getZudelloModelSchema(input.modelName, authContext);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to get model schema");
+            }
+            return {
+                success: true,
+                modelName: input.modelName,
+                data: response.data,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloGetModelSchema error", { modelName: input.modelName }, error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+                modelName: input.modelName,
+                data: null,
+            };
+        }
+    },
+};
+//# sourceMappingURL=get-model-schema.js.map

package/dist/tools/models/get-model-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-model-schema.js","sourceRoot":"","sources":["../../../src/tools/models/get-model-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAG5E;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE;;;qGAGsF;IACnG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gFAAgF;aAC9F;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,OAAO,EAAE,KAAK,EAAE,KAA4B,EAAE,WAAwB,EAAE,EAAE;QACxE,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YAE9E,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAE3E,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,4BAA4B,CAAC,CAAC;YAClE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,KAAc,CAAC,CAAC;YAC5F,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,IAAI;aACX,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}