@zudello/modelcontextprotocol 1.0.0

package/dist/constants/zudello.js

@@ -0,0 +1,1467 @@
+import { z } from "zod";
+/**
+ * Comprehensive Zudello model, module, and submodule definitions.
+ * This module provides shared knowledge of valid combinations across all Zudello tools.
+ *
+ * Data structure based on the official Zudello API specification.
+ */
+// ============================================================================
+// Core Types and Constants
+// ============================================================================
+/**
+ * Valid Zudello models
+ */
+export const ZUDELLO_MODELS = [
+    // Budgets
+    "Budget",
+    // Contracts
+    "Contract",
+    // Dimensional data
+    "Account",
+    "AccountCategory",
+    "AccountGroup",
+    "AccountingPeriod",
+    "AmortizationSchedule",
+    "Batch",
+    "Bin",
+    "ContractCategory",
+    "ContractGroup",
+    "CostCentre",
+    "CostType",
+    "Currency",
+    "CustomerCategory",
+    "CustomerGroup",
+    "Department",
+    "ExpenseCategory",
+    "FixedAsset",
+    "ItemCategory",
+    "ItemGroup",
+    "Location",
+    "MileageRate",
+    "PaymentMethod",
+    "PaymentTerm",
+    "Project",
+    "ProjectGroup",
+    "ProjectTask",
+    "ProjectType",
+    "Subsidiary",
+    "SupplierCategory",
+    "SupplierGroup",
+    "TaxRate",
+    "TaxSolution",
+    "TeamAddress",
+    "UnitOfMeasure",
+    "Warehouse",
+    "Zone",
+    // Transactions (multi-module)
+    "Transaction",
+    // Items
+    "Item",
+    // Relationships
+    "Customer",
+    "Employee",
+    "Supplier",
+];
+/**
+ * Valid Zudello modules
+ */
+export const ZUDELLO_MODULES = [
+    "BUDGETS",
+    "CONTRACTS",
+    "DIMENSIONS",
+    "EXPENSES",
+    "INVENTORY",
+    "PURCHASING",
+    "RELATIONSHIPS",
+    "SALES",
+];
+/**
+ * Valid Zudello submodules
+ */
+export const ZUDELLO_SUBMODULES = [
+    // Budget submodules
+    "BUDGET",
+    // Contract submodules
+    "CONTRACT",
+    // Dimension submodules
+    "ACCOUNT",
+    "ACCOUNT_CATEGORY",
+    "ACCOUNT_GROUP",
+    "ACCOUNTING_PERIOD",
+    "AMORTIZATION_SCHEDULE",
+    "BATCH",
+    "BIN",
+    "CONTRACT_CATEGORY",
+    "CONTRACT_GROUP",
+    "COST_CENTRE",
+    "COST_TYPE",
+    "CURRENCY",
+    "CUSTOMER_CATEGORY",
+    "CUSTOMER_GROUP",
+    "DEPARTMENT",
+    "EXPENSE_CATEGORY",
+    "FIXED_ASSET",
+    "ITEM_CATEGORY",
+    "ITEM_GROUP",
+    "LOCATION",
+    "MILEAGE_RATE",
+    "PAYMENT_METHOD",
+    "PAYMENT_TERM",
+    "PROJECT",
+    "PROJECT_GROUP",
+    "PROJECT_TASK",
+    "PROJECT_TYPE",
+    "SUBSIDIARY",
+    "SUPPLIER_CATEGORY",
+    "SUPPLIER_GROUP",
+    "TAX_RATE",
+    "TAX_SOLUTION",
+    "TEAM_ADDRESS",
+    "UNIT_OF_MEASURE",
+    "WAREHOUSE",
+    "ZONE",
+    // Expense submodules
+    "CLAIM",
+    "EXPENSE",
+    "MILEAGE",
+    "PAYMENT",
+    "REFUND",
+    // Inventory submodules
+    "CATALOGUE",
+    "RECEIPT",
+    // Purchasing submodules
+    "CREDIT",
+    "INVOICE",
+    "ORDER",
+    "QUOTE",
+    "REQUISITION",
+    "RETURN",
+    "STATEMENT",
+    // Relationship submodules
+    "CUSTOMER",
+    "EMPLOYEE",
+    "SUPPLIER",
+    // Sales submodules
+    "REMITTANCE",
+    // Note: CREDIT, INVOICE, ORDER, QUOTE are reused from purchasing
+];
+// ============================================================================
+// Model/Module/Submodule Relationships
+// ============================================================================
+/**
+ * Valid combinations of model, module, and submodule.
+ * Based on the official Zudello API specification.
+ */
+export const ZUDELLO_MODEL_COMBINATIONS = [
+    // Budgets
+    { model: "Budget", module: "BUDGETS", submodule: "BUDGET" },
+    // Contracts
+    { model: "Contract", module: "CONTRACTS", submodule: "CONTRACT" },
+    // Dimensions
+    { model: "Account", module: "DIMENSIONS", submodule: "ACCOUNT" },
+    { model: "AccountCategory", module: "DIMENSIONS", submodule: "ACCOUNT_CATEGORY" },
+    { model: "AccountGroup", module: "DIMENSIONS", submodule: "ACCOUNT_GROUP" },
+    { model: "AccountingPeriod", module: "DIMENSIONS", submodule: "ACCOUNTING_PERIOD" },
+    { model: "AmortizationSchedule", module: "DIMENSIONS", submodule: "AMORTIZATION_SCHEDULE" },
+    { model: "Batch", module: "DIMENSIONS", submodule: "BATCH" },
+    { model: "Bin", module: "DIMENSIONS", submodule: "BIN" },
+    { model: "ContractCategory", module: "DIMENSIONS", submodule: "CONTRACT_CATEGORY" },
+    { model: "ContractGroup", module: "DIMENSIONS", submodule: "CONTRACT_GROUP" },
+    { model: "CostCentre", module: "DIMENSIONS", submodule: "COST_CENTRE" },
+    { model: "CostType", module: "DIMENSIONS", submodule: "COST_TYPE" },
+    { model: "Currency", module: "DIMENSIONS", submodule: "CURRENCY" },
+    { model: "CustomerCategory", module: "DIMENSIONS", submodule: "CUSTOMER_CATEGORY" },
+    { model: "CustomerGroup", module: "DIMENSIONS", submodule: "CUSTOMER_GROUP" },
+    { model: "Department", module: "DIMENSIONS", submodule: "DEPARTMENT" },
+    { model: "ExpenseCategory", module: "DIMENSIONS", submodule: "EXPENSE_CATEGORY" },
+    { model: "FixedAsset", module: "DIMENSIONS", submodule: "FIXED_ASSET" },
+    { model: "ItemCategory", module: "DIMENSIONS", submodule: "ITEM_CATEGORY" },
+    { model: "ItemGroup", module: "DIMENSIONS", submodule: "ITEM_GROUP" },
+    { model: "Location", module: "DIMENSIONS", submodule: "LOCATION" },
+    { model: "MileageRate", module: "DIMENSIONS", submodule: "MILEAGE_RATE" },
+    { model: "PaymentMethod", module: "DIMENSIONS", submodule: "PAYMENT_METHOD" },
+    { model: "PaymentTerm", module: "DIMENSIONS", submodule: "PAYMENT_TERM" },
+    { model: "Project", module: "DIMENSIONS", submodule: "PROJECT" },
+    { model: "ProjectGroup", module: "DIMENSIONS", submodule: "PROJECT_GROUP" },
+    { model: "ProjectTask", module: "DIMENSIONS", submodule: "PROJECT_TASK" },
+    { model: "ProjectType", module: "DIMENSIONS", submodule: "PROJECT_TYPE" },
+    { model: "Subsidiary", module: "DIMENSIONS", submodule: "SUBSIDIARY" },
+    { model: "SupplierCategory", module: "DIMENSIONS", submodule: "SUPPLIER_CATEGORY" },
+    { model: "SupplierGroup", module: "DIMENSIONS", submodule: "SUPPLIER_GROUP" },
+    { model: "TaxRate", module: "DIMENSIONS", submodule: "TAX_RATE" },
+    { model: "TaxSolution", module: "DIMENSIONS", submodule: "TAX_SOLUTION" },
+    { model: "TeamAddress", module: "DIMENSIONS", submodule: "TEAM_ADDRESS" },
+    { model: "UnitOfMeasure", module: "DIMENSIONS", submodule: "UNIT_OF_MEASURE" },
+    { model: "Warehouse", module: "DIMENSIONS", submodule: "WAREHOUSE" },
+    { model: "Zone", module: "DIMENSIONS", submodule: "ZONE" },
+    // Expenses - Transaction model with multiple submodules
+    { model: "Transaction", module: "EXPENSES", submodule: "CLAIM" },
+    { model: "Transaction", module: "EXPENSES", submodule: "EXPENSE" },
+    { model: "Transaction", module: "EXPENSES", submodule: "MILEAGE" },
+    { model: "Transaction", module: "EXPENSES", submodule: "PAYMENT" },
+    { model: "Transaction", module: "EXPENSES", submodule: "REFUND" },
+    // Inventory
+    { model: "Item", module: "INVENTORY", submodule: "CATALOGUE" },
+    { model: "Transaction", module: "INVENTORY", submodule: "RECEIPT" },
+    // Purchasing - Transaction model with multiple submodules
+    { model: "Transaction", module: "PURCHASING", submodule: "CREDIT" },
+    { model: "Transaction", module: "PURCHASING", submodule: "INVOICE" },
+    { model: "Transaction", module: "PURCHASING", submodule: "ORDER" },
+    { model: "Transaction", module: "PURCHASING", submodule: "QUOTE" },
+    { model: "Transaction", module: "PURCHASING", submodule: "REQUISITION" },
+    { model: "Transaction", module: "PURCHASING", submodule: "RETURN" },
+    { model: "Transaction", module: "PURCHASING", submodule: "STATEMENT" },
+    // Relationships
+    { model: "Customer", module: "RELATIONSHIPS", submodule: "CUSTOMER" },
+    { model: "Employee", module: "RELATIONSHIPS", submodule: "EMPLOYEE" },
+    { model: "Supplier", module: "RELATIONSHIPS", submodule: "SUPPLIER" },
+    // Sales - Transaction model with multiple submodules
+    { model: "Transaction", module: "SALES", submodule: "CREDIT" },
+    { model: "Transaction", module: "SALES", submodule: "INVOICE" },
+    { model: "Transaction", module: "SALES", submodule: "ORDER" },
+    { model: "Transaction", module: "SALES", submodule: "QUOTE" },
+    { model: "Transaction", module: "SALES", submodule: "REMITTANCE" },
+];
+// ============================================================================
+// Status Keys and Configurations
+// ============================================================================
+/**
+ * All unique status keys used across Zudello modules.
+ * IMPORTANT: Statuses are user-configurable per organization.
+ * Use zudelloListConfigs with configType 'document_status' to get actual configured statuses.
+ */
+export const ZUDELLO_STATUS_KEYS = [
+    // Common statuses
+    "DRAFT",
+    "ACTIVE",
+    "INACTIVE",
+    "DELETED",
+    "ARCHIVED",
+    "PROCESSING",
+    // Approval workflow statuses
+    "APPROVAL",
+    "REJECT",
+    "REJECTED",
+    "UNABLE",
+    // Document workflow statuses
+    "SCANNING",
+    "REVIEW",
+    "READY",
+    "COMPLETE",
+    "CLOSED",
+    "DUPLICATE",
+    // Purchasing-specific statuses
+    "NEW_VENDOR",
+    "PO_MISSING",
+    "PO_VARIANCE",
+    "GR_PENDING",
+    "PENDING",
+    "PLACED",
+    "PARTIALLY_RECEIVED",
+    "RECEIVED",
+    "PARTIALLY_INVOICED",
+    "INVOICED_NOT_RECEIVED",
+    // Statement-specific statuses
+    "READY_TO_RECONCILE",
+    "RECONCILE",
+    "REQUESTED",
+    // Sales-specific statuses
+    "CUSTOMER_CHECK",
+    "ITEM_CHECK",
+    "PRICE_CHECK",
+    "STOCK_CHECK",
+    "UNSUPPORTED",
+];
+/**
+ * Default status configurations by module/submodule.
+ * IMPORTANT: These are default statuses. Organizations can configure custom statuses.
+ * Use zudelloListConfigs(configType: 'document_status', module, submodule) for actual configs.
+ */
+export const ZUDELLO_STATUS_CONFIGURATIONS = [
+    // BUDGETS / BUDGET
+    { module: "BUDGETS", submodule: "BUDGET", statusName: "Draft", statusKey: "DRAFT" },
+    { module: "BUDGETS", submodule: "BUDGET", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "BUDGETS", submodule: "BUDGET", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "BUDGETS", submodule: "BUDGET", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "BUDGETS", submodule: "BUDGET", statusName: "Active", statusKey: "ACTIVE" },
+    { module: "BUDGETS", submodule: "BUDGET", statusName: "Inactive", statusKey: "INACTIVE" },
+    { module: "BUDGETS", submodule: "BUDGET", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "BUDGETS", submodule: "BUDGET", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "BUDGETS", submodule: "BUDGET", statusName: "Deleted", statusKey: "DELETED" },
+    // CONTRACTS / CONTRACT
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Scanning", statusKey: "SCANNING" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Draft", statusKey: "DRAFT" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Ready", statusKey: "READY" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Active", statusKey: "ACTIVE" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Inactive", statusKey: "INACTIVE" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "CONTRACTS", submodule: "CONTRACT", statusName: "Deleted", statusKey: "DELETED" },
+    // DIMENSIONS - Simple statuses (Draft, Active, Inactive)
+    ...[
+        "ACCOUNT", "ACCOUNT_CATEGORY", "ACCOUNT_GROUP", "ACCOUNTING_PERIOD",
+        "AMORTIZATION_SCHEDULE", "BATCH", "BIN", "CONTRACT_CATEGORY", "CONTRACT_GROUP",
+        "COST_CENTRE", "COST_TYPE", "CURRENCY", "CUSTOMER_CATEGORY", "CUSTOMER_GROUP",
+        "DEPARTMENT", "EXPENSE_CATEGORY", "FIXED_ASSET", "ITEM_CATEGORY", "ITEM_GROUP",
+        "LOCATION", "MILEAGE_RATE", "PAYMENT_TERM", "PROJECT", "PROJECT_GROUP",
+        "PROJECT_TASK", "PROJECT_TYPE", "SUBSIDIARY", "SUPPLIER_CATEGORY", "SUPPLIER_GROUP",
+        "TAX_RATE", "TAX_SOLUTION", "TEAM_ADDRESS", "UNIT_OF_MEASURE", "WAREHOUSE", "ZONE"
+    ].flatMap(submodule => [
+        { module: "DIMENSIONS", submodule, statusName: "Draft", statusKey: "DRAFT" },
+        { module: "DIMENSIONS", submodule, statusName: "Active", statusKey: "ACTIVE" },
+        { module: "DIMENSIONS", submodule, statusName: "Inactive", statusKey: "INACTIVE" },
+    ]),
+    // DIMENSIONS / PAYMENT_METHOD (extended statuses)
+    { module: "DIMENSIONS", submodule: "PAYMENT_METHOD", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "DIMENSIONS", submodule: "PAYMENT_METHOD", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "DIMENSIONS", submodule: "PAYMENT_METHOD", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "DIMENSIONS", submodule: "PAYMENT_METHOD", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "DIMENSIONS", submodule: "PAYMENT_METHOD", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "DIMENSIONS", submodule: "PAYMENT_METHOD", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "DIMENSIONS", submodule: "PAYMENT_METHOD", statusName: "Deleted", statusKey: "DELETED" },
+    // EXPENSES / CLAIM
+    { module: "EXPENSES", submodule: "CLAIM", statusName: "Draft", statusKey: "DRAFT" },
+    { module: "EXPENSES", submodule: "CLAIM", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "EXPENSES", submodule: "CLAIM", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "EXPENSES", submodule: "CLAIM", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "EXPENSES", submodule: "CLAIM", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "EXPENSES", submodule: "CLAIM", statusName: "Completed", statusKey: "COMPLETE" },
+    { module: "EXPENSES", submodule: "CLAIM", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "EXPENSES", submodule: "CLAIM", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "EXPENSES", submodule: "CLAIM", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "EXPENSES", submodule: "CLAIM", statusName: "Deleted", statusKey: "DELETED" },
+    // EXPENSES / EXPENSE
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "Scanning", statusKey: "SCANNING" },
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "Ready", statusKey: "READY" },
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "Completed", statusKey: "COMPLETE" },
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "Duplicate", statusKey: "DUPLICATE" },
+    { module: "EXPENSES", submodule: "EXPENSE", statusName: "Deleted", statusKey: "DELETED" },
+    // EXPENSES / MILEAGE
+    { module: "EXPENSES", submodule: "MILEAGE", statusName: "Scanning", statusKey: "SCANNING" },
+    { module: "EXPENSES", submodule: "MILEAGE", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "EXPENSES", submodule: "MILEAGE", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "EXPENSES", submodule: "MILEAGE", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "EXPENSES", submodule: "MILEAGE", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "EXPENSES", submodule: "MILEAGE", statusName: "Completed", statusKey: "COMPLETE" },
+    { module: "EXPENSES", submodule: "MILEAGE", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "EXPENSES", submodule: "MILEAGE", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "EXPENSES", submodule: "MILEAGE", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "EXPENSES", submodule: "MILEAGE", statusName: "Deleted", statusKey: "DELETED" },
+    // EXPENSES / PAYMENT
+    { module: "EXPENSES", submodule: "PAYMENT", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "EXPENSES", submodule: "PAYMENT", statusName: "Closed", statusKey: "CLOSED" },
+    { module: "EXPENSES", submodule: "PAYMENT", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "EXPENSES", submodule: "PAYMENT", statusName: "Completed", statusKey: "COMPLETE" },
+    // EXPENSES / REFUND
+    { module: "EXPENSES", submodule: "REFUND", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "EXPENSES", submodule: "REFUND", statusName: "Closed", statusKey: "CLOSED" },
+    { module: "EXPENSES", submodule: "REFUND", statusName: "Rejected", statusKey: "REJECTED" },
+    // INVENTORY / CATALOGUE
+    { module: "INVENTORY", submodule: "CATALOGUE", statusName: "Draft", statusKey: "DRAFT" },
+    { module: "INVENTORY", submodule: "CATALOGUE", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "INVENTORY", submodule: "CATALOGUE", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "INVENTORY", submodule: "CATALOGUE", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "INVENTORY", submodule: "CATALOGUE", statusName: "Active", statusKey: "ACTIVE" },
+    { module: "INVENTORY", submodule: "CATALOGUE", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "INVENTORY", submodule: "CATALOGUE", statusName: "Inactive", statusKey: "INACTIVE" },
+    { module: "INVENTORY", submodule: "CATALOGUE", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "INVENTORY", submodule: "CATALOGUE", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "INVENTORY", submodule: "CATALOGUE", statusName: "Duplicate", statusKey: "DUPLICATE" },
+    { module: "INVENTORY", submodule: "CATALOGUE", statusName: "Deleted", statusKey: "DELETED" },
+    // INVENTORY / RECEIPT
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "Scanning", statusKey: "SCANNING" },
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "Ready", statusKey: "READY" },
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "Completed", statusKey: "COMPLETE" },
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "Duplicate", statusKey: "DUPLICATE" },
+    { module: "INVENTORY", submodule: "RECEIPT", statusName: "Deleted", statusKey: "DELETED" },
+    // PURCHASING / CREDIT
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "Scanning", statusKey: "SCANNING" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "New Vendor", statusKey: "NEW_VENDOR" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "Ready", statusKey: "READY" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "Completed", statusKey: "COMPLETE" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "Duplicate", statusKey: "DUPLICATE" },
+    { module: "PURCHASING", submodule: "CREDIT", statusName: "Deleted", statusKey: "DELETED" },
+    // PURCHASING / INVOICE
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "Scanning", statusKey: "SCANNING" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "New Vendor", statusKey: "NEW_VENDOR" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "PO Missing", statusKey: "PO_MISSING" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "PO Variance", statusKey: "PO_VARIANCE" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "GR Pending", statusKey: "GR_PENDING" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "Ready", statusKey: "READY" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "Complete", statusKey: "COMPLETE" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "Duplicate", statusKey: "DUPLICATE" },
+    { module: "PURCHASING", submodule: "INVOICE", statusName: "Deleted", statusKey: "DELETED" },
+    // PURCHASING / ORDER
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Scanning", statusKey: "SCANNING" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Ready", statusKey: "READY" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Pending", statusKey: "PENDING" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Placed", statusKey: "PLACED" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Partially Received", statusKey: "PARTIALLY_RECEIVED" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Received", statusKey: "RECEIVED" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Partially Invoiced", statusKey: "PARTIALLY_INVOICED" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Invoiced Not Received", statusKey: "INVOICED_NOT_RECEIVED" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Closed", statusKey: "CLOSED" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Complete", statusKey: "COMPLETE" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Duplicate", statusKey: "DUPLICATE" },
+    { module: "PURCHASING", submodule: "ORDER", statusName: "Deleted", statusKey: "DELETED" },
+    // PURCHASING / QUOTE, REQUISITION, RETURN (similar pattern)
+    ...["QUOTE", "REQUISITION", "RETURN"].flatMap(submodule => [
+        { module: "PURCHASING", submodule, statusName: "Scanning", statusKey: "SCANNING" },
+        { module: "PURCHASING", submodule, statusName: "User Review", statusKey: "REVIEW" },
+        { module: "PURCHASING", submodule, statusName: "New Vendor", statusKey: "NEW_VENDOR" },
+        { module: "PURCHASING", submodule, statusName: "Ready", statusKey: "READY" },
+        { module: "PURCHASING", submodule, statusName: "Approval", statusKey: "APPROVAL" },
+        { module: "PURCHASING", submodule, statusName: "Reject Review", statusKey: "REJECT" },
+        { module: "PURCHASING", submodule, statusName: "Unable to Process", statusKey: "UNABLE" },
+        { module: "PURCHASING", submodule, statusName: "Completed", statusKey: "COMPLETE" },
+        { module: "PURCHASING", submodule, statusName: "Rejected", statusKey: "REJECTED" },
+        { module: "PURCHASING", submodule, statusName: "Processing", statusKey: "PROCESSING" },
+        { module: "PURCHASING", submodule, statusName: "Archived", statusKey: "ARCHIVED" },
+        { module: "PURCHASING", submodule, statusName: "Duplicate", statusKey: "DUPLICATE" },
+        { module: "PURCHASING", submodule, statusName: "Deleted", statusKey: "DELETED" },
+    ]),
+    // PURCHASING / STATEMENT
+    { module: "PURCHASING", submodule: "STATEMENT", statusName: "Scanning", statusKey: "SCANNING" },
+    { module: "PURCHASING", submodule: "STATEMENT", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "PURCHASING", submodule: "STATEMENT", statusName: "Ready", statusKey: "READY" },
+    { module: "PURCHASING", submodule: "STATEMENT", statusName: "Ready to Reconcile", statusKey: "READY_TO_RECONCILE" },
+    { module: "PURCHASING", submodule: "STATEMENT", statusName: "Reconcile", statusKey: "RECONCILE" },
+    { module: "PURCHASING", submodule: "STATEMENT", statusName: "Requested", statusKey: "REQUESTED" },
+    { module: "PURCHASING", submodule: "STATEMENT", statusName: "Completed", statusKey: "COMPLETE" },
+    { module: "PURCHASING", submodule: "STATEMENT", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "PURCHASING", submodule: "STATEMENT", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "PURCHASING", submodule: "STATEMENT", statusName: "Duplicate", statusKey: "DUPLICATE" },
+    { module: "PURCHASING", submodule: "STATEMENT", statusName: "Deleted", statusKey: "DELETED" },
+    // RELATIONSHIPS / CUSTOMER, EMPLOYEE, SUPPLIER
+    ...["CUSTOMER", "EMPLOYEE", "SUPPLIER"].flatMap(submodule => [
+        { module: "RELATIONSHIPS", submodule, statusName: "Draft", statusKey: "DRAFT" },
+        { module: "RELATIONSHIPS", submodule, statusName: "Approval", statusKey: "APPROVAL" },
+        { module: "RELATIONSHIPS", submodule, statusName: "Reject Review", statusKey: "REJECT" },
+        { module: "RELATIONSHIPS", submodule, statusName: "Unable to Process", statusKey: "UNABLE" },
+        { module: "RELATIONSHIPS", submodule, statusName: "Active", statusKey: "ACTIVE" },
+        { module: "RELATIONSHIPS", submodule, statusName: "Rejected", statusKey: "REJECTED" },
+        { module: "RELATIONSHIPS", submodule, statusName: "Inactive", statusKey: "INACTIVE" },
+        { module: "RELATIONSHIPS", submodule, statusName: "Processing", statusKey: "PROCESSING" },
+        { module: "RELATIONSHIPS", submodule, statusName: "Archived", statusKey: "ARCHIVED" },
+        { module: "RELATIONSHIPS", submodule, statusName: "Deleted", statusKey: "DELETED" },
+    ]),
+    // SALES / CREDIT, INVOICE, REMITTANCE (similar pattern)
+    ...["CREDIT", "INVOICE", "REMITTANCE"].flatMap(submodule => [
+        { module: "SALES", submodule, statusName: "Scanning", statusKey: "SCANNING" },
+        { module: "SALES", submodule, statusName: "User Review", statusKey: "REVIEW" },
+        { module: "SALES", submodule, statusName: "Ready", statusKey: "READY" },
+        { module: "SALES", submodule, statusName: "Approval", statusKey: "APPROVAL" },
+        { module: "SALES", submodule, statusName: "Reject Review", statusKey: "REJECT" },
+        { module: "SALES", submodule, statusName: "Unable to Process", statusKey: "UNABLE" },
+        { module: "SALES", submodule, statusName: "Completed", statusKey: "COMPLETE" },
+        { module: "SALES", submodule, statusName: "Rejected", statusKey: "REJECTED" },
+        { module: "SALES", submodule, statusName: "Processing", statusKey: "PROCESSING" },
+        { module: "SALES", submodule, statusName: "Archived", statusKey: "ARCHIVED" },
+        { module: "SALES", submodule, statusName: "Duplicate", statusKey: "DUPLICATE" },
+        { module: "SALES", submodule, statusName: "Deleted", statusKey: "DELETED" },
+    ]),
+    // SALES / ORDER, QUOTE (with check statuses)
+    ...["ORDER", "QUOTE"].flatMap(submodule => [
+        { module: "SALES", submodule, statusName: "Scanning", statusKey: "SCANNING" },
+        { module: "SALES", submodule, statusName: "User Review", statusKey: "REVIEW" },
+        { module: "SALES", submodule, statusName: "Customer Check", statusKey: "CUSTOMER_CHECK" },
+        { module: "SALES", submodule, statusName: "Item Check", statusKey: "ITEM_CHECK" },
+        { module: "SALES", submodule, statusName: "Price Check", statusKey: "PRICE_CHECK" },
+        { module: "SALES", submodule, statusName: "Stock Check", statusKey: "STOCK_CHECK" },
+        { module: "SALES", submodule, statusName: "Ready", statusKey: "READY" },
+        { module: "SALES", submodule, statusName: "Approval", statusKey: "APPROVAL" },
+        { module: "SALES", submodule, statusName: "Reject Review", statusKey: "REJECT" },
+        { module: "SALES", submodule, statusName: "Unable to Process", statusKey: "UNABLE" },
+        { module: "SALES", submodule, statusName: "Completed", statusKey: "COMPLETE" },
+        { module: "SALES", submodule, statusName: "Rejected", statusKey: "REJECTED" },
+        { module: "SALES", submodule, statusName: "Processing", statusKey: "PROCESSING" },
+        { module: "SALES", submodule, statusName: "Archived", statusKey: "ARCHIVED" },
+        { module: "SALES", submodule, statusName: "Duplicate", statusKey: "DUPLICATE" },
+        { module: "SALES", submodule, statusName: "Deleted", statusKey: "DELETED" },
+    ]),
+    // SALES / RETURN
+    { module: "SALES", submodule: "RETURN", statusName: "User Review", statusKey: "REVIEW" },
+    { module: "SALES", submodule: "RETURN", statusName: "Ready", statusKey: "READY" },
+    { module: "SALES", submodule: "RETURN", statusName: "Approval", statusKey: "APPROVAL" },
+    { module: "SALES", submodule: "RETURN", statusName: "Reject Review", statusKey: "REJECT" },
+    { module: "SALES", submodule: "RETURN", statusName: "Unable to Process", statusKey: "UNABLE" },
+    { module: "SALES", submodule: "RETURN", statusName: "Completed", statusKey: "COMPLETE" },
+    { module: "SALES", submodule: "RETURN", statusName: "Rejected", statusKey: "REJECTED" },
+    { module: "SALES", submodule: "RETURN", statusName: "Processing", statusKey: "PROCESSING" },
+    { module: "SALES", submodule: "RETURN", statusName: "Archived", statusKey: "ARCHIVED" },
+    { module: "SALES", submodule: "RETURN", statusName: "Duplicate", statusKey: "DUPLICATE" },
+    { module: "SALES", submodule: "RETURN", statusName: "Unsupported", statusKey: "UNSUPPORTED" },
+    { module: "SALES", submodule: "RETURN", statusName: "Deleted", statusKey: "DELETED" },
+];
+// ============================================================================
+// Validation Functions
+// ============================================================================
+/**
+ * Check if a model is valid
+ */
+export function isValidZudelloModel(model) {
+    return ZUDELLO_MODELS.includes(model);
+}
+/**
+ * Check if a module is valid
+ */
+export function isValidZudelloModule(module) {
+    return ZUDELLO_MODULES.includes(module);
+}
+/**
+ * Check if a submodule is valid
+ */
+export function isValidZudelloSubmodule(submodule) {
+    return ZUDELLO_SUBMODULES.includes(submodule);
+}
+/**
+ * Check if a model/module/submodule combination is valid
+ */
+export function isValidZudelloCombination(model, module, submodule) {
+    // If only model is provided, check if it's a valid model
+    if (!module && !submodule) {
+        return isValidZudelloModel(model);
+    }
+    // If module/submodule are provided, check the exact combination
+    return ZUDELLO_MODEL_COMBINATIONS.some(combo => {
+        const modelMatch = combo.model === model;
+        const moduleMatch = !module || combo.module === module;
+        const submoduleMatch = !submodule || combo.submodule === submodule;
+        return modelMatch && moduleMatch && submoduleMatch;
+    });
+}
+/**
+ * Get valid modules for a given model
+ */
+export function getValidModulesForModel(model) {
+    return ZUDELLO_MODEL_COMBINATIONS
+        .filter(combo => combo.model === model)
+        .map(combo => combo.module);
+}
+/**
+ * Get valid submodules for a given model and module
+ */
+export function getValidSubmodulesForModel(model, module) {
+    return ZUDELLO_MODEL_COMBINATIONS
+        .filter(combo => {
+        const modelMatch = combo.model === model;
+        const moduleMatch = !module || combo.module === module;
+        return modelMatch && moduleMatch;
+    })
+        .map(combo => combo.submodule);
+}
+/**
+ * Get model combinations by functional area
+ */
+export function getModelsByModule(module) {
+    return ZUDELLO_MODEL_COMBINATIONS
+        .filter(combo => combo.module === module)
+        .map(combo => combo.model);
+}
+// ============================================================================
+// Status Validation and Lookup Functions
+// ============================================================================
+/**
+ * Check if a status key is valid (exists in any context)
+ */
+export function isValidStatusKey(statusKey) {
+    return ZUDELLO_STATUS_KEYS.includes(statusKey);
+}
+/**
+ * Check if a status key is valid for a specific module/submodule context
+ */
+export function isValidStatusForContext(module, submodule, statusKey) {
+    return ZUDELLO_STATUS_CONFIGURATIONS.some(config => config.module === module && config.submodule === submodule && config.statusKey === statusKey);
+}
+/**
+ * Get default statuses for a module/submodule context.
+ * IMPORTANT: These are defaults. Use zudelloListConfigs with configType 'document_status' for actual configs.
+ */
+export function getDefaultStatusesForContext(module, submodule) {
+    return ZUDELLO_STATUS_CONFIGURATIONS.filter(config => config.module === module && config.submodule === submodule);
+}
+/**
+ * Convert a user-friendly status name to its API key for a given context.
+ * Returns undefined if not found.
+ */
+export function getStatusKeyByName(module, submodule, statusName) {
+    const config = ZUDELLO_STATUS_CONFIGURATIONS.find(c => c.module === module && c.submodule === submodule &&
+        c.statusName.toLowerCase() === statusName.toLowerCase());
+    return config?.statusKey;
+}
+/**
+ * Convert an API status key to its user-friendly name for a given context.
+ * Returns undefined if not found.
+ */
+export function getStatusNameByKey(module, submodule, statusKey) {
+    const config = ZUDELLO_STATUS_CONFIGURATIONS.find(c => c.module === module && c.submodule === submodule && c.statusKey === statusKey);
+    return config?.statusName;
+}
+/**
+ * Get common statuses that appear in most contexts.
+ * Useful for general filtering when context is not known.
+ */
+export function getCommonStatuses() {
+    return [
+        { name: "Draft", key: "DRAFT" },
+        { name: "User Review", key: "REVIEW" },
+        { name: "Approval", key: "APPROVAL" },
+        { name: "Ready", key: "READY" },
+        { name: "Complete/Completed", key: "COMPLETE" },
+        { name: "Active", key: "ACTIVE" },
+        { name: "Inactive", key: "INACTIVE" },
+        { name: "Rejected", key: "REJECTED" },
+        { name: "Processing", key: "PROCESSING" },
+        { name: "Archived", key: "ARCHIVED" },
+        { name: "Deleted", key: "DELETED" },
+    ];
+}
+/**
+ * Get a description of status usage for tool documentation.
+ */
+export function getStatusUsageGuide() {
+    return `Common status keys: DRAFT, REVIEW (User Review), APPROVAL, READY, COMPLETE, ACTIVE, INACTIVE, REJECTED, PROCESSING, ARCHIVED, DELETED.
+Module-specific statuses:
+- PURCHASING/INVOICE: NEW_VENDOR, PO_MISSING, PO_VARIANCE, GR_PENDING
+- PURCHASING/ORDER: PENDING, PLACED, RECEIVED, PARTIALLY_RECEIVED, PARTIALLY_INVOICED, CLOSED
+- SALES/ORDER,QUOTE: CUSTOMER_CHECK, ITEM_CHECK, PRICE_CHECK, STOCK_CHECK
+- PURCHASING/STATEMENT: READY_TO_RECONCILE, RECONCILE, REQUESTED
+IMPORTANT: Statuses are user-configurable. If these don't work, use zudelloListConfigs with configType 'document_status' and module/submodule filters to get actual configured statuses.`;
+}
+// ============================================================================
+// Zod Validation Schemas
+// ============================================================================
+/**
+ * Zod schema for Zudello models
+ */
+export const zudelloModelSchema = z.enum(ZUDELLO_MODELS).describe("Valid Zudello model. Common models: Transaction (invoices, orders, receipts), Item (products, inventory), " +
+    "Supplier/Customer/Employee (business entities), Budget/Contract (financial documents), " +
+    "Account/Department/Location (dimensional data). Use zudelloListModels to discover all available models.");
+/**
+ * Zod schema for Zudello modules
+ */
+export const zudelloModuleSchema = z.enum(ZUDELLO_MODULES).describe("Zudello module. Functional areas: BUDGETS (budget planning), CONTRACTS (contract management), " +
+    "DIMENSIONS (reference data), EXPENSES (expense tracking), INVENTORY (stock management), " +
+    "PURCHASING (procurement), RELATIONSHIPS (entities), SALES (revenue tracking).");
+/**
+ * Zod schema for Zudello submodules
+ */
+export const zudelloSubmoduleSchema = z.enum(ZUDELLO_SUBMODULES).describe("Zudello submodule. Specific contexts within modules, e.g., INVOICE/ORDER/QUOTE for transactions, " +
+    "CATALOGUE for items, CUSTOMER/SUPPLIER/EMPLOYEE for relationships.");
+/**
+ * Zod schema for Zudello status keys.
+ * IMPORTANT: Statuses are user-configurable. These are default values.
+ * Use zudelloListConfigs with configType 'document_status' for actual configs.
+ */
+export const zudelloStatusKeySchema = z.enum(ZUDELLO_STATUS_KEYS).describe("Status key for filtering documents. Common values: DRAFT, REVIEW, APPROVAL, READY, COMPLETE, ACTIVE, INACTIVE, REJECTED, PROCESSING, ARCHIVED, DELETED. " +
+    "Module-specific: NEW_VENDOR, PO_MISSING, GR_PENDING (PURCHASING/INVOICE), PENDING, PLACED, RECEIVED (PURCHASING/ORDER). " +
+    "IMPORTANT: Statuses are user-configurable. Use zudelloListConfigs with configType 'document_status' if defaults don't match.");
+/**
+ * Enhanced model schema with validation for combinations
+ */
+export function createValidatedModelSchema(moduleParam, submoduleParam) {
+    return z.string().refine((model) => {
+        if (!isValidZudelloModel(model)) {
+            return false;
+        }
+        if (moduleParam || submoduleParam) {
+            return isValidZudelloCombination(model, moduleParam, submoduleParam);
+        }
+        return true;
+    }, {
+        message: "Invalid model or model/module/submodule combination. Use zudelloListModels to see valid options.",
+    });
+}
+// ============================================================================
+// Utility Functions and Helpers
+// ============================================================================
+/**
+ * Get human-readable description for a model
+ */
+export function getModelDescription(model) {
+    const descriptions = {
+        Budget: "Financial budget planning and tracking",
+        Contract: "Contract management and agreements",
+        Account: "Chart of accounts and accounting structure",
+        AccountCategory: "Grouping categories for accounts",
+        AccountGroup: "Account group classifications",
+        AccountingPeriod: "Financial reporting periods",
+        AmortizationSchedule: "Asset depreciation schedules",
+        Batch: "Inventory batches and lots",
+        Bin: "Storage location bins",
+        ContractCategory: "Contract classification categories",
+        ContractGroup: "Contract group classifications",
+        CostCentre: "Cost center definitions",
+        CostType: "Types of costs and expenses",
+        Currency: "Currency definitions and exchange rates",
+        CustomerCategory: "Customer classification categories",
+        CustomerGroup: "Customer group classifications",
+        Department: "Organizational departments",
+        ExpenseCategory: "Expense classification categories",
+        FixedAsset: "Fixed asset management",
+        ItemCategory: "Product/item classification categories",
+        ItemGroup: "Product/item group classifications",
+        Location: "Physical locations and sites",
+        MileageRate: "Mileage reimbursement rates",
+        PaymentMethod: "Payment method definitions",
+        PaymentTerm: "Payment terms and conditions",
+        Project: "Project management and tracking",
+        ProjectGroup: "Project group classifications",
+        ProjectTask: "Individual project tasks",
+        ProjectType: "Types of projects",
+        Subsidiary: "Company subsidiaries",
+        SupplierCategory: "Supplier classification categories",
+        SupplierGroup: "Supplier group classifications",
+        TaxRate: "Tax rate definitions",
+        TaxSolution: "Tax calculation solutions",
+        TeamAddress: "Team and address information",
+        UnitOfMeasure: "Measurement units (kg, m, etc.)",
+        Warehouse: "Warehouse and storage facilities",
+        Zone: "Geographic or functional zones",
+        Transaction: "Business transactions (invoices, orders, receipts, etc.)",
+        Item: "Products and inventory items",
+        Customer: "Customer relationship management",
+        Employee: "Employee information and management",
+        Supplier: "Supplier relationship management",
+    };
+    return descriptions[model] || "Zudello business entity";
+}
+/**
+ * Get all valid combinations for a specific model
+ */
+export function getCombinationsForModel(model) {
+    return ZUDELLO_MODEL_COMBINATIONS.filter(combo => combo.model === model);
+}
+/**
+ * Format model combinations as human-readable strings
+ */
+export function formatCombination(combination) {
+    return `${combination.model} (${combination.module}/${combination.submodule})`;
+}
+/**
+ * Get examples for tool descriptions
+ */
+export function getModelExamples() {
+    const examples = [
+        "Transaction (invoices, orders, receipts)",
+        "Item (products, inventory)",
+        "Customer/Supplier/Employee (business entities)",
+        "Budget/Contract (financial documents)",
+        "Account/Department/Location (dimensional data)"
+    ];
+    return examples.join(", ");
+}
+// ============================================================================
+// Sentence Automation Constants
+// ============================================================================
+/**
+ * Valid trigger event types for sentence automation.
+ * These determine when a sentence rule is evaluated.
+ */
+export const ZUDELLO_TRIGGER_EVENTS = [
+    "submit",
+    "create",
+    "delete",
+    "update",
+    "converted",
+    "extract",
+    "approval",
+    "related_resource_updated",
+    "button",
+];
+/**
+ * Descriptions for trigger event types
+ */
+export const ZUDELLO_TRIGGER_EVENT_DESCRIPTIONS = {
+    submit: "When a document is submitted for processing",
+    create: "When a new document is created",
+    delete: "When a document is deleted",
+    update: "When a document is updated/modified",
+    converted: "When a document is converted to another type",
+    extract: "When data is extracted from a document (e.g., OCR processing)",
+    approval: "When an approval action occurs (approved/rejected)",
+    related_resource_updated: "When a related resource is updated",
+    button: "When a custom button is clicked",
+};
+/**
+ * Valid action codes for sentence automation.
+ * Use zudelloListSentenceResources with resourceType 'ACTION_TEMPLATE' to get full payload structure.
+ */
+export const ZUDELLO_ACTION_CODES = [
+    "ASSIGN",
+    "UNASSIGN",
+    "UNASSIGN_ALL",
+    "COMPLETE",
+    "SET_STATUS",
+    "SET_FIELD",
+    "GET_APPROVAL",
+    "APPROVAL_DOA",
+    "APPROVAL_MANAGER",
+    "APPROVAL_SET_LIMIT",
+    "MARK_AS_APPROVED",
+    "RESTART_FLOW",
+    "CANCEL_PROCESSING",
+    "CONSOLIDATE_LINES",
+    "REMOVE_MATCHED_LINES",
+    "RUN_INTEGRATION_API_TRIGGER",
+    "START_WORKFLOW",
+    "POST_NOTICE",
+    "CONVERT",
+    "SEND_EMAIL",
+    "GENERATE_PDF",
+    "COMPUTE_FIELD",
+];
+/**
+ * Descriptions for action codes
+ */
+export const ZUDELLO_ACTION_CODE_DESCRIPTIONS = {
+    ASSIGN: "Assign users to a document",
+    UNASSIGN: "Remove specific users from assignment",
+    UNASSIGN_ALL: "Remove all assigned users",
+    COMPLETE: "Complete document processing",
+    SET_STATUS: "Set the document status",
+    SET_FIELD: "Set a specific field value",
+    GET_APPROVAL: "Request approval from specified users",
+    APPROVAL_DOA: "Request approval based on Delegation of Authority",
+    APPROVAL_MANAGER: "Request approval from management tree",
+    APPROVAL_SET_LIMIT: "Set approval limit from dataset",
+    MARK_AS_APPROVED: "Mark document as approved",
+    RESTART_FLOW: "Restart the approval flow",
+    CANCEL_PROCESSING: "Stop/cancel document processing",
+    CONSOLIDATE_LINES: "Consolidate document line items",
+    REMOVE_MATCHED_LINES: "Remove matched line items",
+    RUN_INTEGRATION_API_TRIGGER: "Run an integration API trigger",
+    START_WORKFLOW: "Start a workflow",
+    POST_NOTICE: "Post a notice/notification",
+    CONVERT: "Convert document to another type",
+    SEND_EMAIL: "Send an email notification",
+    GENERATE_PDF: "Generate a PDF document",
+    COMPUTE_FIELD: "Compute/calculate field values",
+};
+/**
+ * Valid condition codes for sentence automation.
+ * Use zudelloListSentenceResources with resourceType 'CONDITION_TEMPLATE' to get full payload structure.
+ */
+export const ZUDELLO_CONDITION_CODES = [
+    "ALLOCATION_PO",
+    "ALLOCATION_RECEIPT",
+    "VARIANCE_AMOUNT",
+    "VARIANCE_PERC",
+    "APPROVED_TRUE",
+    "APPROVED_FALSE",
+];
+/**
+ * Descriptions for condition codes
+ */
+export const ZUDELLO_CONDITION_CODE_DESCRIPTIONS = {
+    ALLOCATION_PO: "Check allocation status against Purchase Order",
+    ALLOCATION_RECEIPT: "Check allocation status against Receipt",
+    VARIANCE_AMOUNT: "Check variance amount (e.g., PO vs Invoice)",
+    VARIANCE_PERC: "Check variance percentage",
+    APPROVED_TRUE: "Document has been approved",
+    APPROVED_FALSE: "Document has not been approved",
+};
+/**
+ * Sentence resource types for the listSentenceResources API
+ */
+export const ZUDELLO_SENTENCE_RESOURCE_TYPES = [
+    "ACTION_TEMPLATE",
+    "CONDITION_TEMPLATE",
+];
+// ============================================================================
+// Sentence Validation and Helper Functions
+// ============================================================================
+/**
+ * Check if a trigger event is valid
+ */
+export function isValidTriggerEvent(event) {
+    return ZUDELLO_TRIGGER_EVENTS.includes(event);
+}
+/**
+ * Check if an action code is valid
+ */
+export function isValidActionCode(code) {
+    return ZUDELLO_ACTION_CODES.includes(code);
+}
+/**
+ * Check if a condition code is valid
+ */
+export function isValidConditionCode(code) {
+    return ZUDELLO_CONDITION_CODES.includes(code);
+}
+/**
+ * Get description for a trigger event
+ */
+export function getTriggerEventDescription(event) {
+    return ZUDELLO_TRIGGER_EVENT_DESCRIPTIONS[event];
+}
+/**
+ * Get description for an action code
+ */
+export function getActionCodeDescription(code) {
+    return ZUDELLO_ACTION_CODE_DESCRIPTIONS[code];
+}
+/**
+ * Get description for a condition code
+ */
+export function getConditionCodeDescription(code) {
+    return ZUDELLO_CONDITION_CODE_DESCRIPTIONS[code];
+}
+/**
+ * Get a usage guide for sentence automation.
+ * This can be referenced by tools for documentation.
+ */
+export function getSentenceUsageGuide() {
+    return `Sentence Automation Guide:
+
+Sentences are automation rules evaluated top-to-bottom when triggered.
+
+TRIGGER EVENTS (when the rule fires):
+- submit: Document submitted for processing
+- create: New document created
+- update: Document modified
+- extract: Data extracted (OCR)
+- approval: Approval action occurred
+- converted: Document converted
+- button: Custom button clicked
+- related_resource_updated: Related resource changed
+- delete: Document deleted
+
+COMMON ACTIONS:
+- ASSIGN/UNASSIGN: Manage document assignees
+- SET_STATUS: Change document status
+- SET_FIELD: Set field values
+- COMPLETE: Complete processing
+- GET_APPROVAL/APPROVAL_DOA/APPROVAL_MANAGER: Request approvals
+- SEND_EMAIL: Send notifications
+- RUN_INTEGRATION_API_TRIGGER: Execute integrations
+- START_WORKFLOW: Begin workflows
+
+CONDITIONS (optional filters):
+- VARIANCE_AMOUNT/VARIANCE_PERC: Check variances
+- APPROVED_TRUE/APPROVED_FALSE: Check approval status
+- ALLOCATION_PO/ALLOCATION_RECEIPT: Check allocations
+
+IMPORTANT:
+1. Use listSentenceResources to get full action/condition payload structures
+2. Sentence order matters - use updateSentencesOrder after creating
+3. Include ALL module sentences when reordering, not just submodule`;
+}
+// ============================================================================
+// Sentence Zod Schemas
+// ============================================================================
+/**
+ * Zod schema for trigger events
+ */
+export const zudelloTriggerEventSchema = z.enum(ZUDELLO_TRIGGER_EVENTS).describe("Trigger event type. Common: submit (document submitted), extract (OCR complete), approval (approval action), " +
+    "update (document modified), create (new document). Others: converted, button, related_resource_updated, delete.");
+/**
+ * Zod schema for action codes
+ */
+export const zudelloActionCodeSchema = z.enum(ZUDELLO_ACTION_CODES).describe("Action code. Common: ASSIGN (assign users), COMPLETE (finish processing), SET_STATUS, SET_FIELD, " +
+    "GET_APPROVAL/APPROVAL_DOA/APPROVAL_MANAGER (request approvals), SEND_EMAIL, START_WORKFLOW. " +
+    "Use listSentenceResources with resourceType 'ACTION_TEMPLATE' for full payload structure.");
+/**
+ * Zod schema for condition codes
+ */
+export const zudelloConditionCodeSchema = z.enum(ZUDELLO_CONDITION_CODES).describe("Condition code. VARIANCE_AMOUNT/VARIANCE_PERC (check variances), APPROVED_TRUE/APPROVED_FALSE (approval status), " +
+    "ALLOCATION_PO/ALLOCATION_RECEIPT (allocation status). Use listSentenceResources with resourceType 'CONDITION_TEMPLATE' for full payload.");
+/**
+ * Zod schema for sentence resource types
+ */
+export const zudelloSentenceResourceTypeSchema = z.enum(ZUDELLO_SENTENCE_RESOURCE_TYPES).describe("Sentence resource type. ACTION_TEMPLATE: available actions for sentences. CONDITION_TEMPLATE: available conditions for sentences.");
+/**
+ * Common action templates with complete payload structures
+ * Extracted from sentence_actions.md
+ */
+export const ZUDELLO_ACTION_TEMPLATES = {
+    ASSIGN: {
+        code: "ASSIGN",
+        name: "assign",
+        operator: {
+            value: "add_to_array",
+            default: "add_to_array",
+            use: "uuid"
+        },
+        field: {
+            value: "assignees",
+            meta: {
+                path: "assignees",
+                type: "Relation",
+                label: "Assignees",
+                sentence_path: "assignees",
+                display_format: "{first_name} {last_name}",
+                options: {
+                    use: "uuid",
+                    model: "AssignedUser",
+                    source: "team-data",
+                    relation_type: "One-to-Many"
+                }
+            }
+        },
+        values: [],
+        template: "assign {value}"
+    },
+    SET_STATUS: {
+        code: "SET_STATUS",
+        name: "set status",
+        operator: {
+            value: "set_value",
+            default: "set_value",
+            use: "key"
+        },
+        field: {
+            value: "status",
+            meta: {
+                path: "status",
+                type: "Relation",
+                label: "Status",
+                sentence_path: "status",
+                display_format: "name",
+                options: {
+                    use: "key",
+                    model: "Status",
+                    source: "general-store"
+                }
+            }
+        },
+        values: [],
+        template: "set status to {value}"
+    },
+    GET_APPROVAL: {
+        code: "GET_APPROVAL",
+        name: "get approval",
+        operator: {
+            value: "approve_document",
+            default: "approve_document"
+        },
+        values: [],
+        template: "get approval {value}"
+    },
+    APPROVAL_DOA: {
+        code: "APPROVAL_DOA",
+        name: "get approval (DoA)",
+        operator: {
+            value: "approve_document_doa",
+            default: "approve_document_doa"
+        },
+        values: [],
+        template: "get approval {value}"
+    },
+    APPROVAL_MANAGER: {
+        code: "APPROVAL_MANAGER",
+        name: "get approval (Management Tree)",
+        operator: {
+            value: "approve_document_manager",
+            default: "approve_document_manager"
+        },
+        values: [],
+        template: "get approval {value}"
+    },
+    MARK_AS_APPROVED: {
+        code: "MARK_AS_APPROVED",
+        name: "mark as approved",
+        operator: {
+            value: "set_value",
+            default: "set_value"
+        },
+        field: {
+            value: "is_approved",
+            meta: {
+                path: "is_approved",
+                type: "Boolean",
+                label: "Is Approved",
+                sentence_path: "is_approved"
+            }
+        },
+        values: [{
+                value: true,
+                source: "internal",
+                default: true
+            }],
+        template: "mark as approved"
+    },
+    CANCEL_PROCESSING: {
+        code: "CANCEL_PROCESSING",
+        name: "stop processing",
+        operator: {
+            value: "cancel",
+            default: "cancel"
+        },
+        values: [],
+        template: "stop processing"
+    },
+    COMPLETE: {
+        code: "COMPLETE",
+        name: "complete processing",
+        operator: {
+            value: "complete_document",
+            default: "complete_document"
+        },
+        values: [],
+        template: "complete processing"
+    },
+    SET_FIELD: {
+        code: "SET_FIELD",
+        name: "set field",
+        operator: {
+            value: "set_value",
+            default: "set_value"
+        },
+        values: [],
+        template: "set {field} to {value}"
+    },
+    SEND_EMAIL: {
+        code: "SEND_EMAIL",
+        name: "send email",
+        operator: {
+            value: "send_email",
+            default: "send_email"
+        },
+        values: [],
+        template: "send email {value}"
+    },
+    RUN_INTEGRATION_API_TRIGGER: {
+        code: "RUN_INTEGRATION_API_TRIGGER",
+        name: "run trigger",
+        operator: {
+            value: "run_integration_api_trigger",
+            default: "run_integration_api_trigger"
+        },
+        values: [],
+        template: "run {value}"
+    },
+    START_WORKFLOW: {
+        code: "START_WORKFLOW",
+        name: "start workflow",
+        operator: {
+            value: "run_workflow",
+            default: "run_workflow"
+        },
+        values: [],
+        template: "start workflow {value}"
+    }
+};
+/**
+ * Common condition templates with complete payload structures
+ * Extracted from sentence_conditions.md
+ */
+export const ZUDELLO_CONDITION_TEMPLATES = {
+    APPROVED_TRUE: {
+        code: "APPROVED_TRUE",
+        name: "has been approved",
+        operator: {
+            value: "==",
+            default: "=="
+        },
+        field: {
+            value: "is_approved",
+            meta: {
+                path: "is_approved",
+                type: "Boolean",
+                label: "Is Approved",
+                sentence_path: "is_approved"
+            }
+        },
+        values: [{
+                value: true,
+                source: "internal",
+                default: true
+            }],
+        template: "has been approved"
+    },
+    APPROVED_FALSE: {
+        code: "APPROVED_FALSE",
+        name: "has not been approved",
+        operator: {
+            value: "==",
+            default: "=="
+        },
+        field: {
+            value: "is_approved",
+            meta: {
+                path: "is_approved",
+                type: "Boolean",
+                label: "Is Approved",
+                sentence_path: "is_approved"
+            }
+        },
+        values: [{
+                value: false,
+                source: "internal",
+                default: false
+            }],
+        template: "has not been approved"
+    },
+    VARIANCE_AMOUNT: {
+        code: "VARIANCE_AMOUNT",
+        name: "Variance Amount",
+        operator: {
+            value: ">=",
+            default: ">="
+        },
+        field: {
+            value: "variance_amount_local_json.purchasing_order",
+            meta: {
+                path: "variance_amount_local_json__purchasing_order",
+                type: "Number",
+                label: "Purchasing Order",
+                sentence_path: "variance_amount_local_json.purchasing_order"
+            }
+        },
+        values: [],
+        template: "Variance Amount {operator} {value}"
+    },
+    VARIANCE_PERC: {
+        code: "VARIANCE_PERC",
+        name: "Variance Percentage",
+        operator: {
+            value: ">=",
+            default: ">="
+        },
+        field: {
+            value: "variance_percentage_json.purchasing_order",
+            meta: {
+                path: "variance_percentage_json__purchasing_order",
+                type: "Number",
+                label: "Purchasing Order",
+                sentence_path: "variance_percentage_json.purchasing_order"
+            }
+        },
+        values: [],
+        template: "Variance Percentage {operator}{value}%"
+    },
+    ALLOCATION_PO: {
+        code: "ALLOCATION_PO",
+        name: "Allocation Status - PO",
+        operator: {
+            value: "==",
+            default: "=="
+        },
+        field: {
+            value: "allocation_status_json.purchasing_order",
+            meta: {
+                path: "allocation_status_json__purchasing_order",
+                type: "String",
+                label: "Purchasing Order",
+                sentence_path: "allocation_status_json.purchasing_order"
+            }
+        },
+        values: [],
+        template: "Allocation Status - Purchase Order {operator} {value}"
+    },
+    ALLOCATION_RECEIPT: {
+        code: "ALLOCATION_RECEIPT",
+        name: "Allocation Status - Receipt",
+        operator: {
+            value: "==",
+            default: "=="
+        },
+        field: {
+            value: "allocation_status_json.inventory_receipt",
+            meta: {
+                path: "allocation_status_json__inventory_receipt",
+                type: "String",
+                label: "Inventory Receipt",
+                sentence_path: "allocation_status_json.inventory_receipt"
+            }
+        },
+        values: [],
+        template: "Allocation Status - Receipt {operator} {value}"
+    }
+};
+// ============================================================================
+// Template Generation Utilities
+// ============================================================================
+/**
+ * Get an action template by code
+ */
+export function getActionTemplate(code) {
+    return ZUDELLO_ACTION_TEMPLATES[code];
+}
+/**
+ * Get a condition template by code
+ */
+export function getConditionTemplate(code) {
+    return ZUDELLO_CONDITION_TEMPLATES[code];
+}
+/**
+ * Generate a sentence action payload from template
+ */
+export function generateActionPayload(code, values, field, operator, otherwise) {
+    const template = getActionTemplate(code);
+    if (!template) {
+        throw new Error(`Action template not found for code: ${code}`);
+    }
+    return {
+        code: template.code,
+        name: template.name,
+        operator: {
+            value: operator || template.operator.value,
+            default: template.operator.default,
+            ...(template.operator.use && { use: template.operator.use })
+        },
+        ...(template.field && {
+            field: {
+                value: field || template.field.value,
+                meta: template.field.meta
+            }
+        }),
+        values: values || template.values || [],
+        template: template.template,
+        ...(otherwise !== undefined && { otherwise })
+    };
+}
+/**
+ * Generate a sentence condition payload from template
+ */
+export function generateConditionPayload(code, values, field, operator) {
+    const template = getConditionTemplate(code);
+    if (!template) {
+        throw new Error(`Condition template not found for code: ${code}`);
+    }
+    return {
+        code: template.code,
+        name: template.name,
+        operator: {
+            value: operator || template.operator.value,
+            default: template.operator.default,
+            ...(template.operator.use && { use: template.operator.use })
+        },
+        field: {
+            value: field || template.field.value,
+            meta: template.field.meta
+        },
+        values: values || template.values
+    };
+}
+/**
+ * Generate a complete sentence recipe with trigger, conditions, and actions
+ */
+export function generateSentenceRecipe(options) {
+    return {
+        changeable: options.changeable ?? true,
+        trigger: {
+            trigger: "TEAM_DATA",
+            event_type: options.trigger.event_type,
+            event_model: options.trigger.event_model || "Transaction",
+            module: options.trigger.module,
+            submodule: options.trigger.submodule,
+            enabled: options.trigger.enabled ?? true,
+            changeable: true
+        },
+        conditions: (options.conditions || []).map(condition => ({
+            ...generateConditionPayload(condition.code, condition.values, condition.field, condition.operator),
+            changeable: true
+        })),
+        actions: options.actions.map(action => ({
+            ...generateActionPayload(action.code, action.values, action.field, action.operator, action.otherwise),
+            changeable: true
+        }))
+    };
+}
+/**
+ * Common sentence recipe templates for typical workflows
+ */
+export const SENTENCE_RECIPE_TEMPLATES = {
+    /**
+     * Simple status change on document submit
+     */
+    SIMPLE_STATUS_CHANGE: (module, submodule, statusKey) => generateSentenceRecipe({
+        trigger: {
+            module,
+            submodule,
+            event_type: "submit"
+        },
+        actions: [{
+                code: "SET_STATUS",
+                values: [{ value: { key: statusKey }, source: "internal" }]
+            }]
+    }),
+    /**
+     * Approval workflow with fallback to rejected status
+     */
+    APPROVAL_WITH_FALLBACK: (module, submodule, approvalType = "GET_APPROVAL") => generateSentenceRecipe({
+        trigger: {
+            module,
+            submodule,
+            event_type: "submit"
+        },
+        actions: [
+            {
+                code: approvalType,
+                values: [] // Must be populated with approval configuration
+            },
+            {
+                code: "SET_STATUS",
+                values: [{ value: { key: "REJECT" }, source: "internal" }],
+                otherwise: true
+            },
+            {
+                code: "ASSIGN",
+                values: [{ value: "submitted_by", source: "external", meta: { path: "submitted_by", type: "Relation" } }]
+            },
+            {
+                code: "CANCEL_PROCESSING"
+            }
+        ]
+    }),
+    /**
+     * Conditional processing based on document type
+     */
+    CONDITIONAL_BY_DOCUMENT_TYPE: (module, submodule, documentTypeProperty, actions) => generateSentenceRecipe({
+        trigger: {
+            module,
+            submodule,
+            event_type: "submit"
+        },
+        conditions: [{
+                code: "CUSTOM_CONDITION", // This would need to be added to condition templates
+                field: "document_type",
+                operator: "==",
+                values: [{ value: { property: documentTypeProperty }, source: "internal" }]
+            }],
+        actions
+    })
+};
+//# sourceMappingURL=zudello.js.map