@zudello/modelcontextprotocol 1.0.0

package/dist/tools/exceptions/budget/create-budget-exception-reason.js

@@ -0,0 +1,82 @@
+import { logger } from "../../../utils/logger.js";
+import { createZudelloConfig } from "../../../services/zudello/index.js";
+export const zudelloCreateBudgetExceptionReason = {
+    name: "zudelloCreateBudgetExceptionReason",
+    description: `Create a new budget exception reason for the team.
+
+Budget exception reasons justify approving documents that exceed allocated budgets.
+
+Required fields:
+- code: Short identifier code (e.g., "OOB", "ABD", "EMERGENCY")
+- name: Display name (e.g., "Out of Budget Spend Approval Obtained")
+- commentRequired: Boolean - require approver to add justification comment
+- context: Module/submodule mapping where this reason can be used
+
+Context format - module to submodules mapping:
+Common modules: PURCHASING, SALES, EXPENSES, LEDGER, INVENTORY
+Common submodules: QUOTE, REQUISITION, ORDER, INVOICE, RETURN, CREDIT, STATEMENT, PAYMENT, EXPENSE, MILEAGE, JOURNAL
+
+Example:
+{
+  "code": "APPROVED_VARIANCE",
+  "name": "Pre-Approved Budget Variance",
+  "commentRequired": true,
+  "context": {
+    "PURCHASING": ["INVOICE", "ORDER", "CREDIT"],
+    "EXPENSES": ["EXPENSE", "MILEAGE"]
+  }
+}
+
+Use cases:
+- Add exception reasons for newly approved spending categories
+- Create temporary reasons for one-time projects
+- Set up industry-specific justification options`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            code: {
+                type: "string",
+                description: "Short code for the reason (e.g., OOB, ABD)"
+            },
+            name: {
+                type: "string",
+                description: "Display name for the reason"
+            },
+            commentRequired: {
+                type: "boolean",
+                description: "Whether approver must add justification comment"
+            },
+            context: {
+                type: "object",
+                description: "Module/submodule mapping where this reason applies"
+            }
+        },
+        required: ["code", "name", "commentRequired", "context"]
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloCreateBudgetExceptionReason executed", { code: input.code });
+            const payload = {
+                code: input.code,
+                name: input.name,
+                comment_required: input.commentRequired
+            };
+            const response = await createZudelloConfig(authContext, "budget_reason", payload, input.context);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to create budget exception reason");
+            }
+            return {
+                success: true,
+                budgetReason: response.data
+            };
+        }
+        catch (error) {
+            logger.error("zudelloCreateBudgetExceptionReason error", { code: input.code }, error);
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+};
+//# sourceMappingURL=create-budget-exception-reason.js.map

package/dist/tools/exceptions/budget/create-budget-exception-reason.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-budget-exception-reason.js","sourceRoot":"","sources":["../../../../src/tools/exceptions/budget/create-budget-exception-reason.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGzE,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDA4BkC;IAC/C,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,iDAAiD;aAC/D;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oDAAoD;aAClE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,CAAC;KACzD;IACD,OAAO,EAAE,KAAK,EACZ,KAKC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,6CAA6C,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAEjF,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,gBAAgB,EAAE,KAAK,CAAC,eAAe;aACxC,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAEjG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0CAA0C,CAAC,CAAC;YAChF,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,QAAQ,CAAC,IAAI;aAC5B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,0CAA0C,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAc,CAAC,CAAC;YAC/F,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/exceptions/budget/index.d.ts

@@ -0,0 +1,4 @@
+export { zudelloListBudgetExceptionReasons } from "./list-budget-exception-reasons.js";
+export { zudelloCreateBudgetExceptionReason } from "./create-budget-exception-reason.js";
+export { zudelloUpdateBudgetExceptionReason } from "./update-budget-exception-reason.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/exceptions/budget/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/exceptions/budget/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC;AACzF,OAAO,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/tools/exceptions/budget/index.js

@@ -0,0 +1,4 @@
+export { zudelloListBudgetExceptionReasons } from "./list-budget-exception-reasons.js";
+export { zudelloCreateBudgetExceptionReason } from "./create-budget-exception-reason.js";
+export { zudelloUpdateBudgetExceptionReason } from "./update-budget-exception-reason.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/exceptions/budget/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/exceptions/budget/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC;AACzF,OAAO,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/tools/exceptions/budget/list-budget-exception-reasons.d.ts

@@ -0,0 +1,29 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloListBudgetExceptionReasons: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    execute: (input: Record<string, unknown>, authContext: AuthContext) => Promise<{
+        success: boolean;
+        budgetReasons: {
+            uuid: any;
+            context: any;
+            code: any;
+            name: any;
+            commentRequired: any;
+            createdAt: any;
+            updatedAt: any;
+        }[];
+        count: number;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        budgetReasons: never[];
+        count?: undefined;
+    }>;
+};
+//# sourceMappingURL=list-budget-exception-reasons.d.ts.map

package/dist/tools/exceptions/budget/list-budget-exception-reasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-budget-exception-reasons.d.ts","sourceRoot":"","sources":["../../../../src/tools/exceptions/budget/list-budget-exception-reasons.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,iCAAiC;;;;;;;qBAwBrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,WAAW;;;;;;;;;;;;;;;;;;;CAmCzE,CAAC"}

package/dist/tools/exceptions/budget/list-budget-exception-reasons.js

@@ -0,0 +1,60 @@
+import { logger } from "../../../utils/logger.js";
+import { listZudelloConfigs } from "../../../services/zudello/index.js";
+export const zudelloListBudgetExceptionReasons = {
+    name: "zudelloListBudgetExceptionReasons",
+    description: `List all budget exception reasons configured for the team.
+
+Budget exception reasons are used when approving documents that exceed budget thresholds,
+requiring users to justify the overspend.
+
+Each reason includes:
+- uuid: Unique identifier
+- context: Module/submodule mapping where this reason applies
+- code: Short code for the reason
+- name: Display name
+- commentRequired: Whether approver must add comment
+
+Example context: {"PURCHASING": ["INVOICE", "ORDER", "REQUISITION"]}
+
+Use cases:
+- Review available reasons before processing over-budget invoices
+- Audit exception reasons for compliance reporting
+- Identify which reasons are used across different modules`,
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.debug("zudelloListBudgetExceptionReasons executed");
+            const response = await listZudelloConfigs(authContext, "budget_reason", false);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to list budget exception reasons");
+            }
+            // Format for better readability
+            const reasons = (response.data || []).map((reason) => ({
+                uuid: reason.uuid,
+                context: reason.context,
+                code: reason.payload?.code,
+                name: reason.payload?.name,
+                commentRequired: reason.payload?.comment_required,
+                createdAt: reason.created_at,
+                updatedAt: reason.updated_at,
+            }));
+            return {
+                success: true,
+                budgetReasons: reasons,
+                count: reasons.length,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloListBudgetExceptionReasons error", {}, error);
+            return {
+                success: false,
+                error: error.message,
+                budgetReasons: [],
+            };
+        }
+    },
+};
+//# sourceMappingURL=list-budget-exception-reasons.js.map

package/dist/tools/exceptions/budget/list-budget-exception-reasons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-budget-exception-reasons.js","sourceRoot":"","sources":["../../../../src/tools/exceptions/budget/list-budget-exception-reasons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAGxE,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE;;;;;;;;;;;;;;;;;2DAiB4C;IACzD,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,4CAA4C,CAAC,CAAC;YAE3D,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;YAE/E,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,yCAAyC,CAAC,CAAC;YAC/E,CAAC;YAED,gCAAgC;YAChC,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,CAAC;gBAC1D,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI;gBAC1B,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI;gBAC1B,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB;gBACjD,SAAS,EAAE,MAAM,CAAC,UAAU;gBAC5B,SAAS,EAAE,MAAM,CAAC,UAAU;aAC7B,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,aAAa,EAAE,OAAO;gBACtB,KAAK,EAAE,OAAO,CAAC,MAAM;aACtB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,aAAa,EAAE,EAAE;aAClB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/exceptions/budget/update-budget-exception-reason.d.ts

@@ -0,0 +1,47 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloUpdateBudgetExceptionReason: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            uuid: {
+                type: string;
+                description: string;
+            };
+            code: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            commentRequired: {
+                type: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        uuid: string;
+        code: string;
+        name: string;
+        commentRequired: boolean;
+        context: Record<string, string[]>;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        budgetReason: any;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        budgetReason?: undefined;
+    }>;
+};
+//# sourceMappingURL=update-budget-exception-reason.d.ts.map

package/dist/tools/exceptions/budget/update-budget-exception-reason.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-budget-exception-reason.d.ts","sourceRoot":"","sources":["../../../../src/tools/exceptions/budget/update-budget-exception-reason.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAiDpC;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,OAAO,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;KACnC,eACY,WAAW;;;;;;;;;CA6B3B,CAAC"}

package/dist/tools/exceptions/budget/update-budget-exception-reason.js

@@ -0,0 +1,77 @@
+import { logger } from "../../../utils/logger.js";
+import { updateZudelloConfig } from "../../../services/zudello/index.js";
+export const zudelloUpdateBudgetExceptionReason = {
+    name: "zudelloUpdateBudgetExceptionReason",
+    description: `Update an existing budget exception reason.
+
+Modify the code, name, comment requirement, or context for an existing budget exception reason.
+
+Required fields:
+- uuid: UUID of the reason to update
+- code: Updated short code
+- name: Updated display name
+- commentRequired: Updated comment requirement
+- context: Updated module/submodule mapping
+
+IMPORTANT:
+- Always fetch current reason first with zudelloListBudgetExceptionReasons
+- Provide complete payload - partial updates not supported
+- Changing context affects which documents can use this reason
+
+Use cases:
+- Rename reasons for clarity
+- Expand or restrict context (module/submodule applicability)
+- Toggle comment requirements based on policy changes`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            uuid: {
+                type: "string",
+                description: "UUID of the budget exception reason to update"
+            },
+            code: {
+                type: "string",
+                description: "Updated short code"
+            },
+            name: {
+                type: "string",
+                description: "Updated display name"
+            },
+            commentRequired: {
+                type: "boolean",
+                description: "Updated comment requirement"
+            },
+            context: {
+                type: "object",
+                description: "Updated module/submodule mapping"
+            }
+        },
+        required: ["uuid", "code", "name", "commentRequired", "context"]
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloUpdateBudgetExceptionReason executed", { uuid: input.uuid, code: input.code });
+            const payload = {
+                code: input.code,
+                name: input.name,
+                comment_required: input.commentRequired
+            };
+            const response = await updateZudelloConfig(authContext, input.uuid, "budget_reason", payload, input.context);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to update budget exception reason");
+            }
+            return {
+                success: true,
+                budgetReason: response.data
+            };
+        }
+        catch (error) {
+            logger.error("zudelloUpdateBudgetExceptionReason error", { uuid: input.uuid }, error);
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+};
+//# sourceMappingURL=update-budget-exception-reason.js.map

package/dist/tools/exceptions/budget/update-budget-exception-reason.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-budget-exception-reason.js","sourceRoot":"","sources":["../../../../src/tools/exceptions/budget/update-budget-exception-reason.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGzE,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EAAE;;;;;;;;;;;;;;;;;;;sDAmBuC;IACpD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oBAAoB;aAClC;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sBAAsB;aACpC;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,6BAA6B;aAC3C;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,CAAC;KACjE;IACD,OAAO,EAAE,KAAK,EACZ,KAMC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,6CAA6C,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAEnG,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,gBAAgB,EAAE,KAAK,CAAC,eAAe;aACxC,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAE7G,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0CAA0C,CAAC,CAAC;YAChF,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,QAAQ,CAAC,IAAI;aAC5B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,0CAA0C,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAc,CAAC,CAAC;YAC/F,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/exceptions/contract/create-contract-exception-reason.d.ts

@@ -0,0 +1,42 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloCreateContractExceptionReason: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            code: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            commentRequired: {
+                type: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        code: string;
+        name: string;
+        commentRequired: boolean;
+        context: Record<string, string[]>;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        contractReason: any;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        contractReason?: undefined;
+    }>;
+};
+//# sourceMappingURL=create-contract-exception-reason.d.ts.map

package/dist/tools/exceptions/contract/create-contract-exception-reason.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-contract-exception-reason.d.ts","sourceRoot":"","sources":["../../../../src/tools/exceptions/contract/create-contract-exception-reason.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;qBAsDtC;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,OAAO,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;KACnC,eACY,WAAW;;;;;;;;;CA6B3B,CAAC"}

package/dist/tools/exceptions/contract/create-contract-exception-reason.js

@@ -0,0 +1,82 @@
+import { logger } from "../../../utils/logger.js";
+import { createZudelloConfig } from "../../../services/zudello/index.js";
+export const zudelloCreateContractExceptionReason = {
+    name: "zudelloCreateContractExceptionReason",
+    description: `Create a new contract exception reason for the team.
+
+Contract exception reasons justify approving contracts that deviate from standard terms or pricing.
+
+Required fields:
+- code: Short identifier code (e.g., "BPV", "STRATEGIC", "URGENT")
+- name: Display name (e.g., "Better Price/Value", "Strategic Partnership")
+- commentRequired: Boolean - require approver to add justification comment
+- context: Module/submodule mapping where this reason can be used
+
+Context format - module to submodules mapping:
+Common modules: PURCHASING, SALES
+Common submodules: QUOTE, ORDER, CONTRACT
+
+Example:
+{
+  "code": "STRATEGIC",
+  "name": "Strategic Partnership Pricing",
+  "commentRequired": true,
+  "context": {
+    "PURCHASING": ["ORDER", "QUOTE"],
+    "SALES": ["QUOTE"]
+  }
+}
+
+Use cases:
+- Add reasons for new contract approval policies
+- Create exception paths for strategic partnerships
+- Set up justification options for urgent orders`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            code: {
+                type: "string",
+                description: "Short code for the reason"
+            },
+            name: {
+                type: "string",
+                description: "Display name for the reason"
+            },
+            commentRequired: {
+                type: "boolean",
+                description: "Whether approver must add justification comment"
+            },
+            context: {
+                type: "object",
+                description: "Module/submodule mapping where this reason applies"
+            }
+        },
+        required: ["code", "name", "commentRequired", "context"]
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloCreateContractExceptionReason executed", { code: input.code });
+            const payload = {
+                code: input.code,
+                name: input.name,
+                comment_required: input.commentRequired
+            };
+            const response = await createZudelloConfig(authContext, "contract_reason", payload, input.context);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to create contract exception reason");
+            }
+            return {
+                success: true,
+                contractReason: response.data
+            };
+        }
+        catch (error) {
+            logger.error("zudelloCreateContractExceptionReason error", { code: input.code }, error);
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+};
+//# sourceMappingURL=create-contract-exception-reason.js.map

package/dist/tools/exceptions/contract/create-contract-exception-reason.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-contract-exception-reason.js","sourceRoot":"","sources":["../../../../src/tools/exceptions/contract/create-contract-exception-reason.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGzE,MAAM,CAAC,MAAM,oCAAoC,GAAG;IAClD,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDA4BkC;IAC/C,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2BAA2B;aACzC;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,iDAAiD;aAC/D;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oDAAoD;aAClE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,CAAC;KACzD;IACD,OAAO,EAAE,KAAK,EACZ,KAKC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,+CAA+C,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAEnF,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,gBAAgB,EAAE,KAAK,CAAC,eAAe;aACxC,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAEnG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,4CAA4C,CAAC,CAAC;YAClF,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,cAAc,EAAE,QAAQ,CAAC,IAAI;aAC9B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4CAA4C,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAc,CAAC,CAAC;YACjG,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/exceptions/contract/index.d.ts

@@ -0,0 +1,4 @@
+export { zudelloListContractExceptionReasons } from "./list-contract-exception-reasons.js";
+export { zudelloCreateContractExceptionReason } from "./create-contract-exception-reason.js";
+export { zudelloUpdateContractExceptionReason } from "./update-contract-exception-reason.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/exceptions/contract/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/exceptions/contract/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mCAAmC,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,EAAE,oCAAoC,EAAE,MAAM,uCAAuC,CAAC;AAC7F,OAAO,EAAE,oCAAoC,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/tools/exceptions/contract/index.js

@@ -0,0 +1,4 @@
+export { zudelloListContractExceptionReasons } from "./list-contract-exception-reasons.js";
+export { zudelloCreateContractExceptionReason } from "./create-contract-exception-reason.js";
+export { zudelloUpdateContractExceptionReason } from "./update-contract-exception-reason.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/exceptions/contract/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/exceptions/contract/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mCAAmC,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,EAAE,oCAAoC,EAAE,MAAM,uCAAuC,CAAC;AAC7F,OAAO,EAAE,oCAAoC,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/tools/exceptions/contract/list-contract-exception-reasons.d.ts

@@ -0,0 +1,29 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloListContractExceptionReasons: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    execute: (input: Record<string, unknown>, authContext: AuthContext) => Promise<{
+        success: boolean;
+        contractReasons: {
+            uuid: any;
+            context: any;
+            code: any;
+            name: any;
+            commentRequired: any;
+            createdAt: any;
+            updatedAt: any;
+        }[];
+        count: number;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        contractReasons: never[];
+        count?: undefined;
+    }>;
+};
+//# sourceMappingURL=list-contract-exception-reasons.d.ts.map

package/dist/tools/exceptions/contract/list-contract-exception-reasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-contract-exception-reasons.d.ts","sourceRoot":"","sources":["../../../../src/tools/exceptions/contract/list-contract-exception-reasons.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mCAAmC;;;;;;;qBAwBvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,WAAW;;;;;;;;;;;;;;;;;;;CAmCzE,CAAC"}

package/dist/tools/exceptions/contract/list-contract-exception-reasons.js

@@ -0,0 +1,60 @@
+import { logger } from "../../../utils/logger.js";
+import { listZudelloConfigs } from "../../../services/zudello/index.js";
+export const zudelloListContractExceptionReasons = {
+    name: "zudelloListContractExceptionReasons",
+    description: `List all contract exception reasons configured for the team.
+
+Contract exception reasons are used when approving contracts or purchase orders that deviate from
+standard terms or pricing agreements, requiring users to justify the variance.
+
+Each reason includes:
+- uuid: Unique identifier
+- context: Module/submodule mapping where this reason applies
+- code: Short code for the reason
+- name: Display name
+- commentRequired: Whether approver must add comment
+
+Example context: {"PURCHASING": ["ORDER", "QUOTE"]}
+
+Use cases:
+- Review available reasons before approving non-standard contracts
+- Audit exception reasons for compliance reporting
+- Identify which reasons are used across different modules`,
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.debug("zudelloListContractExceptionReasons executed");
+            const response = await listZudelloConfigs(authContext, "contract_reason", false);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to list contract exception reasons");
+            }
+            // Format for better readability
+            const reasons = (response.data || []).map((reason) => ({
+                uuid: reason.uuid,
+                context: reason.context,
+                code: reason.payload?.code,
+                name: reason.payload?.name,
+                commentRequired: reason.payload?.comment_required,
+                createdAt: reason.created_at,
+                updatedAt: reason.updated_at,
+            }));
+            return {
+                success: true,
+                contractReasons: reasons,
+                count: reasons.length,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloListContractExceptionReasons error", {}, error);
+            return {
+                success: false,
+                error: error.message,
+                contractReasons: [],
+            };
+        }
+    },
+};
+//# sourceMappingURL=list-contract-exception-reasons.js.map

package/dist/tools/exceptions/contract/list-contract-exception-reasons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-contract-exception-reasons.js","sourceRoot":"","sources":["../../../../src/tools/exceptions/contract/list-contract-exception-reasons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAGxE,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE;;;;;;;;;;;;;;;;;2DAiB4C;IACzD,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,8CAA8C,CAAC,CAAC;YAE7D,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;YAEjF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,2CAA2C,CAAC,CAAC;YACjF,CAAC;YAED,gCAAgC;YAChC,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,CAAC;gBAC1D,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI;gBAC1B,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI;gBAC1B,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB;gBACjD,SAAS,EAAE,MAAM,CAAC,UAAU;gBAC5B,SAAS,EAAE,MAAM,CAAC,UAAU;aAC7B,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,eAAe,EAAE,OAAO;gBACxB,KAAK,EAAE,OAAO,CAAC,MAAM;aACtB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC9E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,eAAe,EAAE,EAAE;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/exceptions/contract/update-contract-exception-reason.d.ts

@@ -0,0 +1,47 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloUpdateContractExceptionReason: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            uuid: {
+                type: string;
+                description: string;
+            };
+            code: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            commentRequired: {
+                type: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        uuid: string;
+        code: string;
+        name: string;
+        commentRequired: boolean;
+        context: Record<string, string[]>;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        contractReason: any;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        contractReason?: undefined;
+    }>;
+};
+//# sourceMappingURL=update-contract-exception-reason.d.ts.map

package/dist/tools/exceptions/contract/update-contract-exception-reason.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-contract-exception-reason.d.ts","sourceRoot":"","sources":["../../../../src/tools/exceptions/contract/update-contract-exception-reason.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAiDtC;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,OAAO,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;KACnC,eACY,WAAW;;;;;;;;;CA6B3B,CAAC"}