@zudello/modelcontextprotocol 1.0.0

package/dist/tools/config/list-configs.d.ts

@@ -0,0 +1,48 @@
+import type { AuthContext } from "../../context/auth.js";
+/**
+ * List configurations by type
+ */
+export declare const zudelloListConfigs: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            configType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            globalConfig: {
+                type: string;
+                description: string;
+            };
+            module: {
+                type: string;
+                description: string;
+            };
+            submodule: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        configType: string;
+        globalConfig?: boolean;
+        module?: string;
+        submodule?: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        configs: any[] | undefined;
+        count: number;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        configs: null;
+        count?: undefined;
+    }>;
+};
+//# sourceMappingURL=list-configs.d.ts.map

package/dist/tools/config/list-configs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-configs.d.ts","sourceRoot":"","sources":["../../../src/tools/config/list-configs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAUzD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;qBAuCpB;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,eACY,WAAW;;;;;;;;;;;CA+B3B,CAAC"}

package/dist/tools/config/list-configs.js

@@ -0,0 +1,74 @@
+import { logger } from "../../utils/logger.js";
+import { listZudelloConfigs } from "../../services/zudello/documents.js";
+const CONFIG_TYPES = [
+    "budget_config", "budget_reason", "dashboard", "dataset",
+    "document_coding", "document_status", "document_type", "document_view",
+    "export_template", "field_settings", "inbox_template", "language_placeholders",
+    "notification_template", "pdf_template", "quick_actions", "team_setting",
+    "workflow", "workflow_properties"
+];
+/**
+ * List configurations by type
+ */
+export const zudelloListConfigs = {
+    name: "zudelloListConfigs",
+    description: `List configurations in Zudello by type. Does not include sentence configs.
+
+Common config types:
+- field_settings: Field configuration settings - USE THIS BEFORE zudelloSearch to discover valid fields
+- document_status: Status definitions for documents
+- document_type: Document type definitions
+- workflow: Workflow configurations
+- dashboard: Dashboard layouts
+- pdf_template: PDF templates
+
+IMPORTANT - Before using zudelloSearch with specific fields:
+1. Call this with configType 'field_settings' and the target module/submodule
+2. The payload contains field definitions - use these field names in your search 'select' array`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            configType: {
+                type: "string",
+                enum: CONFIG_TYPES,
+                description: "Type of config to list",
+            },
+            globalConfig: {
+                type: "boolean",
+                description: "Whether to include global configs (default: false)",
+            },
+            module: {
+                type: "string",
+                description: "Optional module filter (BUDGETS, CONTRACTS, EXPENSES, INVENTORY, PURCHASING, SALES, etc.)",
+            },
+            submodule: {
+                type: "string",
+                description: "Optional submodule filter (e.g., 'INVOICE', 'ORDER')",
+            },
+        },
+        required: ["configType"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloListConfigs executed", { configType: input.configType });
+            const response = await listZudelloConfigs(authContext, input.configType, input.globalConfig ?? false, input.module, input.submodule);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to list configs");
+            }
+            return {
+                success: true,
+                configs: response.data,
+                count: response.data?.length || 0,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloListConfigs error", { configType: input.configType }, error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+                configs: null,
+            };
+        }
+    },
+};
+//# sourceMappingURL=list-configs.js.map

package/dist/tools/config/list-configs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-configs.js","sourceRoot":"","sources":["../../../src/tools/config/list-configs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAGzE,MAAM,YAAY,GAAG;IACnB,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS;IACxD,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe;IACtE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB;IAC9E,uBAAuB,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc;IACxE,UAAU,EAAE,qBAAqB;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;;;;;;;;;;;gGAYiF;IAC9F,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,wBAAwB;aACtC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,oDAAoD;aAClE;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2FAA2F;aACzG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sDAAsD;aACpE;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;IACD,OAAO,EAAE,KAAK,EACZ,KAKC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YAE7E,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CACvC,WAAW,EACX,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,YAAY,IAAI,KAAK,EAC3B,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,SAAS,CAChB,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC;YAC9D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,QAAQ,CAAC,IAAI;gBACtB,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,KAAc,CAAC,CAAC;YAC3F,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/config/update-config.d.ts

@@ -0,0 +1,48 @@
+import type { AuthContext } from "../../context/auth.js";
+/**
+ * Update an existing configuration (WRITE - requires approval)
+ */
+export declare const zudelloUpdateConfig: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            configUuid: {
+                type: string;
+                description: string;
+            };
+            configType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            payload: {
+                type: string;
+                description: string;
+            };
+            configContext: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        configUuid: string;
+        configType: string;
+        payload: Record<string, unknown>;
+        configContext: Record<string, string[]>;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        config: any;
+        message: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        config: null;
+        message?: undefined;
+    }>;
+};
+//# sourceMappingURL=update-config.d.ts.map

package/dist/tools/config/update-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-config.d.ts","sourceRoot":"","sources":["../../../src/tools/config/update-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAUzD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;qBA6BrB;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;KACzC,eACY,WAAW;;;;;;;;;;;CA+B3B,CAAC"}

package/dist/tools/config/update-config.js

@@ -0,0 +1,64 @@
+import { logger } from "../../utils/logger.js";
+import { updateZudelloConfig } from "../../services/zudello/documents.js";
+const CONFIG_TYPES = [
+    "budget_config", "budget_reason", "dashboard", "dataset",
+    "document_coding", "document_status", "document_type", "document_view",
+    "export_template", "field_settings", "inbox_template", "language_placeholders",
+    "notification_template", "pdf_template", "quick_actions", "team_setting",
+    "workflow", "workflow_properties"
+];
+/**
+ * Update an existing configuration (WRITE - requires approval)
+ */
+export const zudelloUpdateConfig = {
+    name: "zudelloUpdateConfig",
+    description: `Update a specific Config UUID in Zudello with new payload data.
+
+IMPORTANT: Always use getConfig first to retrieve the current payload structure, then modify only the specific fields you need to change while preserving all other fields.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            configUuid: {
+                type: "string",
+                description: "The exact UUID of the config to update",
+            },
+            configType: {
+                type: "string",
+                enum: CONFIG_TYPES,
+                description: "The type of config being updated",
+            },
+            payload: {
+                type: "object",
+                description: "The complete payload data. Must include ALL original fields - use getConfig first",
+            },
+            configContext: {
+                type: "object",
+                description: "REQUIRED: The context object specifying module/submodule",
+            },
+        },
+        required: ["configUuid", "configType", "payload", "configContext"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloUpdateConfig executed", { configUuid: input.configUuid });
+            const response = await updateZudelloConfig(authContext, input.configUuid, input.configType, input.payload, input.configContext);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to update config");
+            }
+            return {
+                success: true,
+                config: response.data,
+                message: "Config updated successfully",
+            };
+        }
+        catch (error) {
+            logger.error("zudelloUpdateConfig error", { configUuid: input.configUuid }, error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+                config: null,
+            };
+        }
+    },
+};
+//# sourceMappingURL=update-config.js.map

package/dist/tools/config/update-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-config.js","sourceRoot":"","sources":["../../../src/tools/config/update-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAG1E,MAAM,YAAY,GAAG;IACnB,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS;IACxD,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe;IACtE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB;IAC9E,uBAAuB,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc;IACxE,UAAU,EAAE,qBAAqB;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;4KAE6J;IAC1K,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,kCAAkC;aAChD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mFAAmF;aACjG;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,CAAC;KACnE;IACD,OAAO,EAAE,KAAK,EACZ,KAKC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YAE9E,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CACxC,WAAW,EACX,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,aAAa,CACpB,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,yBAAyB,CAAC,CAAC;YAC/D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,QAAQ,CAAC,IAAI;gBACrB,OAAO,EAAE,6BAA6B;aACvC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,KAAc,CAAC,CAAC;YAC5F,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,MAAM,EAAE,IAAI;aACb,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/config/update-configs-order.d.ts

@@ -0,0 +1,39 @@
+import type { AuthContext } from "../../context/auth.js";
+/**
+ * Update the display order of configurations (WRITE - requires approval)
+ */
+export declare const zudelloUpdateConfigsOrder: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            configType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            uuids: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        configType: string;
+        uuids: string[];
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        message: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        message?: undefined;
+    }>;
+};
+//# sourceMappingURL=update-configs-order.d.ts.map

package/dist/tools/config/update-configs-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-configs-order.d.ts","sourceRoot":"","sources":["../../../src/tools/config/update-configs-order.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAUzD;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;qBAsB3B;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,eACY,WAAW;;;;;;;;;CA0B3B,CAAC"}

package/dist/tools/config/update-configs-order.js

@@ -0,0 +1,58 @@
+import { logger } from "../../utils/logger.js";
+import { updateZudelloConfigsOrder } from "../../services/zudello/documents.js";
+const CONFIG_TYPES = [
+    "budget_config", "budget_reason", "dashboard", "dataset",
+    "document_coding", "document_status", "document_type", "document_view",
+    "export_template", "field_settings", "inbox_template", "language_placeholders",
+    "notification_template", "pdf_template", "quick_actions", "team_setting",
+    "workflow", "workflow_properties"
+];
+/**
+ * Update the display order of configurations (WRITE - requires approval)
+ */
+export const zudelloUpdateConfigsOrder = {
+    name: "zudelloUpdateConfigsOrder",
+    description: `Update the display order of configs of a specific type.
+
+Provide the UUIDs in the desired order. This affects how configs are displayed in lists.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            configType: {
+                type: "string",
+                enum: CONFIG_TYPES,
+                description: "The type of config to reorder",
+            },
+            uuids: {
+                type: "array",
+                items: { type: "string" },
+                description: "Array of config UUIDs in the desired order",
+            },
+        },
+        required: ["configType", "uuids"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloUpdateConfigsOrder executed", {
+                configType: input.configType,
+                count: input.uuids.length,
+            });
+            const response = await updateZudelloConfigsOrder(authContext, input.configType, input.uuids);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to update config order");
+            }
+            return {
+                success: true,
+                message: `Successfully updated order for ${input.uuids.length} configs`,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloUpdateConfigsOrder error", { configType: input.configType }, error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+            };
+        }
+    },
+};
+//# sourceMappingURL=update-configs-order.js.map

package/dist/tools/config/update-configs-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-configs-order.js","sourceRoot":"","sources":["../../../src/tools/config/update-configs-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAGhF,MAAM,YAAY,GAAG;IACnB,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS;IACxD,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe;IACtE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB;IAC9E,uBAAuB,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc;IACxE,UAAU,EAAE,qBAAqB;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE;;yFAE0E;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,+BAA+B;aAC7C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,4CAA4C;aAC1D;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;KAClC;IACD,OAAO,EAAE,KAAK,EACZ,KAGC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;gBAChD,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAE7F,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,+BAA+B,CAAC,CAAC;YACrE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,kCAAkC,KAAK,CAAC,KAAK,CAAC,MAAM,UAAU;aACxE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,KAAc,CAAC,CAAC;YAClG,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/connections/check-connection-status.d.ts

@@ -0,0 +1,60 @@
+import type { AuthContext } from "../../context/auth.js";
+export declare const zudelloCheckConnectionStatus: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            appUuid: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    execute: (input: {
+        appUuid?: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        connections: {
+            name: string;
+            status: string;
+            uuid: string;
+            updatedAt: string;
+        }[];
+        count: number;
+        summary: string;
+        statusSummary?: undefined;
+        issues?: undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        connections: {
+            integration: string;
+            connectionName: string;
+            status: string;
+            connectionUuid: string;
+            appUuid: string;
+            statusCheckedAt: string;
+        }[];
+        count: number;
+        statusSummary: Record<string, number>;
+        issues: {
+            integration: string;
+            connectionName: string;
+            status: string;
+            connectionUuid: string;
+            appUuid: string;
+        }[] | null;
+        summary: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        connections: never[];
+        count?: undefined;
+        summary?: undefined;
+        statusSummary?: undefined;
+        issues?: undefined;
+    }>;
+};
+//# sourceMappingURL=check-connection-status.d.ts.map

package/dist/tools/connections/check-connection-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-connection-status.d.ts","sourceRoot":"","sources":["../../../src/tools/connections/check-connection-status.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;qBAiBhB;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFtE,CAAC"}

package/dist/tools/connections/check-connection-status.js

@@ -0,0 +1,94 @@
+import { logger } from "../../utils/logger.js";
+import { getConnectionStatus, getAllConnectionStatuses } from "../../services/zudello/connections.js";
+export const zudelloCheckConnectionStatus = {
+    name: "zudelloCheckConnectionStatus",
+    description: `Check the health/status of integration connections.
+
+Returns the current status of each connection (e.g., "CONNECTED", "DISCONNECTED", "ERROR").
+Useful for troubleshooting integration issues - disconnected connections are likely causes of sync failures.
+
+Can check all connections or filter by appUuid. The tool checks ALL connections by default.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            appUuid: {
+                type: "string",
+                description: "Optional: UUID of specific integration app to check. If not provided, checks all connections.",
+            },
+        },
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.debug("zudelloCheckConnectionStatus executed", { appUuid: input.appUuid });
+            if (input.appUuid) {
+                // Check specific app
+                const response = await getConnectionStatus(authContext, input.appUuid);
+                if (!response.success) {
+                    throw new Error(response.error || "Failed to check connection status");
+                }
+                const statuses = response.data || [];
+                return {
+                    success: true,
+                    connections: statuses.map((s) => ({
+                        name: s.name,
+                        status: s.status,
+                        uuid: s.uuid,
+                        updatedAt: s.updatedAt,
+                    })),
+                    count: statuses.length,
+                    summary: statuses.length > 0
+                        ? `Found ${statuses.length} connection(s): ${statuses.map((s) => `${s.name} (${s.status})`).join(", ")}`
+                        : "No connections found for this app",
+                };
+            }
+            else {
+                // Check all connections
+                const response = await getAllConnectionStatuses(authContext);
+                if (!response.success) {
+                    throw new Error(response.error || "Failed to check connection statuses");
+                }
+                const connections = response.data || [];
+                // Group by status
+                const statusCounts = connections.reduce((acc, c) => {
+                    acc[c.status] = (acc[c.status] || 0) + 1;
+                    return acc;
+                }, {});
+                const disconnected = connections.filter((c) => c.status !== "CONNECTED");
+                return {
+                    success: true,
+                    connections: connections.map((c) => ({
+                        integration: c.appName,
+                        connectionName: c.connectionName,
+                        status: c.status,
+                        connectionUuid: c.connectionUuid,
+                        appUuid: c.appUuid,
+                        statusCheckedAt: c.statusCheckedAt,
+                    })),
+                    count: connections.length,
+                    statusSummary: statusCounts,
+                    issues: disconnected.length > 0
+                        ? disconnected.map((c) => ({
+                            integration: c.appName,
+                            connectionName: c.connectionName,
+                            status: c.status,
+                            connectionUuid: c.connectionUuid,
+                            appUuid: c.appUuid,
+                        }))
+                        : null,
+                    summary: disconnected.length === 0
+                        ? `All ${connections.length} connection(s) are CONNECTED`
+                        : `${disconnected.length} of ${connections.length} connection(s) have issues`,
+                };
+            }
+        }
+        catch (error) {
+            logger.error("zudelloCheckConnectionStatus error", input, error);
+            return {
+                success: false,
+                error: error.message,
+                connections: [],
+            };
+        }
+    },
+};
+//# sourceMappingURL=check-connection-status.js.map

package/dist/tools/connections/check-connection-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-connection-status.js","sourceRoot":"","sources":["../../../src/tools/connections/check-connection-status.ts"],"names":[],"mappings":"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"}

package/dist/tools/connections/get-connection-template.d.ts

@@ -0,0 +1,44 @@
+import type { AuthContext } from "../../context/auth.js";
+export declare const zudelloGetConnectionTemplate: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            appUuid: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        appUuid: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        templates: {
+            uuid: string;
+            name: string;
+            type: string;
+            description: string | null;
+            parameters: {
+                name: string;
+                type: string;
+                label: string;
+                required: boolean;
+            }[];
+        }[];
+        count: number;
+        defaultTemplate: import("../../services/zudello/connections.js").ConnectionTemplate | null;
+        summary: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        templates: never[];
+        count?: undefined;
+        defaultTemplate?: undefined;
+        summary?: undefined;
+    }>;
+};
+//# sourceMappingURL=get-connection-template.d.ts.map

package/dist/tools/connections/get-connection-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-connection-template.d.ts","sourceRoot":"","sources":["../../../src/tools/connections/get-connection-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;qBAkBhB;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCrE,CAAC"}

package/dist/tools/connections/get-connection-template.js

@@ -0,0 +1,55 @@
+import { logger } from "../../utils/logger.js";
+import { getConnectionTemplate } from "../../services/zudello/connections.js";
+export const zudelloGetConnectionTemplate = {
+    name: "zudelloGetConnectionTemplate",
+    description: `Get the connection template for a specific integration app.
+
+Returns parameters required to create a connection, including field names, types, and labels.
+Use before setting up a new connection to understand required credentials/parameters.
+
+The appUuid can be obtained from zudelloListAvailableIntegrations.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            appUuid: {
+                type: "string",
+                description: "UUID of the integration app to get template for",
+            },
+        },
+        required: ["appUuid"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.debug("zudelloGetConnectionTemplate executed", input);
+            const response = await getConnectionTemplate(authContext, input.appUuid);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to get connection template");
+            }
+            const templates = response.data || [];
+            return {
+                success: true,
+                templates: templates.map((t) => ({
+                    uuid: t.uuid,
+                    name: t.name,
+                    type: t.type,
+                    description: t.description,
+                    parameters: t.parameters,
+                })),
+                count: templates.length,
+                defaultTemplate: templates.length === 1 ? templates[0] : null,
+                summary: templates.length === 1
+                    ? `Found 1 connection template "${templates[0].name}" with ${templates[0].parameters.length} parameter(s)`
+                    : `Found ${templates.length} connection template(s): ${templates.map((t) => t.name).join(", ")}`,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloGetConnectionTemplate error", input, error);
+            return {
+                success: false,
+                error: error.message,
+                templates: [],
+            };
+        }
+    },
+};
+//# sourceMappingURL=get-connection-template.js.map

package/dist/tools/connections/get-connection-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-connection-template.js","sourceRoot":"","sources":["../../../src/tools/connections/get-connection-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAG9E,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE;;;;;mEAKoD;IACjE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iDAAiD;aAC/D;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,OAAO,EAAE,KAAK,EAAE,KAA0B,EAAE,WAAwB,EAAE,EAAE;QACtE,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;YAE7D,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAEzE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,mCAAmC,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YAEtC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;iBACzB,CAAC,CAAC;gBACH,KAAK,EAAE,SAAS,CAAC,MAAM;gBACvB,eAAe,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC7D,OAAO,EACL,SAAS,CAAC,MAAM,KAAK,CAAC;oBACpB,CAAC,CAAC,gCAAgC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,eAAe;oBAC1G,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,4BAA4B,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACrG,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC1E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,SAAS,EAAE,EAAE;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Connection Management - MCP Tools
+ * Category: connections
+ * Read Operations: 4 | Write Operations: 1
+ */
+export { zudelloListConnections } from "./list-connections.js";
+export { zudelloCheckConnectionStatus } from "./check-connection-status.js";
+export { zudelloReconnect } from "./reconnect.js";
+export { zudelloListAvailableIntegrations } from "./list-available-integrations.js";
+export { zudelloGetConnectionTemplate } from "./get-connection-template.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/connections/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC"}