@zudello/modelcontextprotocol 1.0.0

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * Model Discovery Tools - MCP Tools
+ * Category: models
+ * Read Operations (5 tools)
+ */
+export { zudelloListModels } from "./list-models.js";
+export { zudelloGetModelMetadata } from "./get-model-metadata.js";
+export { zudelloGetModelSchema } from "./get-model-schema.js";
+export { zudelloGetModelRelations } from "./get-model-relations.js";
+export { zudelloGetFieldMetadata } from "./get-field-metadata.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/models/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/tools/models/index.js

@@ -0,0 +1,11 @@
+/**
+ * Model Discovery Tools - MCP Tools
+ * Category: models
+ * Read Operations (5 tools)
+ */
+export { zudelloListModels } from "./list-models.js";
+export { zudelloGetModelMetadata } from "./get-model-metadata.js";
+export { zudelloGetModelSchema } from "./get-model-schema.js";
+export { zudelloGetModelRelations } from "./get-model-relations.js";
+export { zudelloGetFieldMetadata } from "./get-field-metadata.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/models/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/tools/models/list-models.d.ts

@@ -0,0 +1,24 @@
+import type { AuthContext } from "../../context/auth.js";
+/**
+ * List all available Zudello models
+ */
+export declare const zudelloListModels: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    execute: (input: Record<string, never>, authContext: AuthContext) => Promise<{
+        success: boolean;
+        data: string[] | undefined;
+        count: number;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        data: null;
+        count?: undefined;
+    }>;
+};
+//# sourceMappingURL=list-models.d.ts.map

package/dist/tools/models/list-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-models.d.ts","sourceRoot":"","sources":["../../../src/tools/models/list-models.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;qBAgBL,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,eAAe,WAAW;;;;;;;;;;;CAwBvE,CAAC"}

package/dist/tools/models/list-models.js

@@ -0,0 +1,45 @@
+import { logger } from "../../utils/logger.js";
+import { listZudelloModels } from "../../services/zudello/resources.js";
+/**
+ * List all available Zudello models
+ */
+export const zudelloListModels = {
+    name: "zudelloListModels",
+    description: `List all available data models in Zudello that can be used in search queries and other operations.
+
+Model/Module/Submodule relationships:
+- Transaction: Used across EXPENSES, INVENTORY, PURCHASING, SALES modules
+- Item: Used with INVENTORY module
+- Customer/Supplier/Employee: RELATIONSHIPS module
+- Budget: BUDGETS module | Contract: CONTRACTS module
+- Dimensional models (Account, Department, Location, etc.): DIMENSIONS module
+
+Note: Transaction is a polymorphic model - filter by module/submodule to get specific transaction types.`,
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloListModels executed");
+            const response = await listZudelloModels(authContext);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to list models");
+            }
+            return {
+                success: true,
+                data: response.data,
+                count: response.data?.length || 0,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloListModels error", {}, error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+                data: null,
+            };
+        }
+    },
+};
+//# sourceMappingURL=list-models.js.map

package/dist/tools/models/list-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-models.js","sourceRoot":"","sources":["../../../src/tools/models/list-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAGxE;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;yGAS0F;IACvG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;KACf;IACD,OAAO,EAAE,KAAK,EAAE,KAA4B,EAAE,WAAwB,EAAE,EAAE;QACxE,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAE1C,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;YAEtD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAC;YAC7D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC5D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,IAAI,EAAE,IAAI;aACX,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/notifications/get-notification-preferences.d.ts

@@ -0,0 +1,41 @@
+import type { AuthContext } from "../../context/auth.js";
+export declare const zudelloGetNotificationPreferences: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            userUuid: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        userUuid: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        preferences: {
+            uuid: string;
+            userId: string;
+            notificationTypeUuid: string;
+            channels: {
+                email: boolean;
+                web: boolean;
+                mobile: boolean;
+                slack: boolean;
+                teams: boolean;
+            };
+            disabled: boolean;
+        }[];
+        count: number;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        preferences: never[];
+        count?: undefined;
+    }>;
+};
+//# sourceMappingURL=get-notification-preferences.d.ts.map

package/dist/tools/notifications/get-notification-preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-notification-preferences.d.ts","sourceRoot":"","sources":["../../../src/tools/notifications/get-notification-preferences.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;qBAgCrB;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;;;;;;;;;;;;;CAuCtE,CAAC"}

package/dist/tools/notifications/get-notification-preferences.js

@@ -0,0 +1,72 @@
+import { logger } from "../../utils/logger.js";
+import { getZudelloNotificationPreferences } from "../../services/zudello/index.js";
+export const zudelloGetNotificationPreferences = {
+    name: "zudelloGetNotificationPreferences",
+    description: `Get notification preferences for a specific user.
+
+Returns the user's configured notification channels for each notification type.
+Notification settings are team-specific - users can have different preferences per team.
+
+Each preference includes:
+- uuid: Preference record UUID
+- user_id: User UUID
+- notification_type: Notification type UUID
+- email: Email notifications enabled
+- web: In-app notifications enabled
+- mobile: Mobile push enabled
+- slack: Slack notifications enabled
+- teams: Microsoft Teams enabled
+- disabled: Completely disabled
+
+Workflow:
+1. Get user UUID via zudelloGetUsers if needed
+2. Call this tool with user UUID
+3. Cross-reference notification_type UUIDs with zudelloListNotificationTypes`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            userUuid: {
+                type: "string",
+                description: "UUID of the user whose preferences to retrieve",
+            },
+        },
+        required: ["userUuid"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.debug("zudelloGetNotificationPreferences executed", { userUuid: input.userUuid });
+            const response = await getZudelloNotificationPreferences(authContext, input.userUuid);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to get notification preferences");
+            }
+            // Format for better readability
+            const preferences = (response.data || []).map((pref) => ({
+                uuid: pref.uuid,
+                userId: pref.user_id,
+                notificationTypeUuid: pref.notification_type,
+                channels: {
+                    email: pref.email,
+                    web: pref.web,
+                    mobile: pref.mobile,
+                    slack: pref.slack,
+                    teams: pref.teams,
+                },
+                disabled: pref.disabled,
+            }));
+            return {
+                success: true,
+                preferences,
+                count: preferences.length,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloGetNotificationPreferences error", { userUuid: input.userUuid }, error);
+            return {
+                success: false,
+                error: error.message,
+                preferences: [],
+            };
+        }
+    },
+};
+//# sourceMappingURL=get-notification-preferences.js.map

package/dist/tools/notifications/get-notification-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-notification-preferences.js","sourceRoot":"","sources":["../../../src/tools/notifications/get-notification-preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AAGpF,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;6EAmB8D;IAC3E,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;IACD,OAAO,EAAE,KAAK,EAAE,KAA2B,EAAE,WAAwB,EAAE,EAAE;QACvE,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,4CAA4C,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAEzF,MAAM,QAAQ,GAAG,MAAM,iCAAiC,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YAEtF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wCAAwC,CAAC,CAAC;YAC9E,CAAC;YAED,gCAAgC;YAChC,MAAM,WAAW,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACvD,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,OAAO;gBACpB,oBAAoB,EAAE,IAAI,CAAC,iBAAiB;gBAC5C,QAAQ,EAAE;oBACR,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,KAAK,EAAE,IAAI,CAAC,KAAK;iBAClB;gBACD,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW;gBACX,KAAK,EAAE,WAAW,CAAC,MAAM;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAc,CAAC,CAAC;YACtG,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,WAAW,EAAE,EAAE;aAChB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,4 @@
+export { zudelloListNotificationTypes } from "./list-notification-types.js";
+export { zudelloGetNotificationPreferences } from "./get-notification-preferences.js";
+export { zudelloUpdateNotificationPreferences } from "./update-notification-preferences.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AACtF,OAAO,EAAE,oCAAoC,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/tools/notifications/index.js

@@ -0,0 +1,4 @@
+export { zudelloListNotificationTypes } from "./list-notification-types.js";
+export { zudelloGetNotificationPreferences } from "./get-notification-preferences.js";
+export { zudelloUpdateNotificationPreferences } from "./update-notification-preferences.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AACtF,OAAO,EAAE,oCAAoC,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/tools/notifications/list-notification-types.d.ts

@@ -0,0 +1,23 @@
+import type { AuthContext } from "../../context/auth.js";
+export declare const zudelloListNotificationTypes: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    execute: (input: Record<string, unknown>, authContext: AuthContext) => Promise<{
+        success: boolean;
+        notificationTypes: import("../../services/zudello/types.js").NotificationType[];
+        byGroup: Record<string, import("../../services/zudello/types.js").NotificationType[]>;
+        count: number;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        notificationTypes: never[];
+        byGroup?: undefined;
+        count?: undefined;
+    }>;
+};
+//# sourceMappingURL=list-notification-types.d.ts.map

package/dist/tools/notifications/list-notification-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-notification-types.d.ts","sourceRoot":"","sources":["../../../src/tools/notifications/list-notification-types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,4BAA4B;;;;;;;qBAoBhB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,WAAW;;;;;;;;;;;;;CAoCzE,CAAC"}

package/dist/tools/notifications/list-notification-types.js

@@ -0,0 +1,56 @@
+import { logger } from "../../utils/logger.js";
+import { listZudelloNotificationTypes } from "../../services/zudello/index.js";
+export const zudelloListNotificationTypes = {
+    name: "zudelloListNotificationTypes",
+    description: `List all notification types available for configuration.
+
+Notification types define the different events that can trigger notifications, grouped by category.
+Each type has channels that can be enabled (email, web, mobile, slack, teams).
+
+Returns notification types with:
+- uuid: Unique identifier
+- name: Internal key
+- group: Category grouping
+- label: Human-readable name
+- description: Trigger explanation
+- priority: Display order
+
+Common types include assignee, mention, approval_required, contract_renewal_reminder.`,
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.debug("zudelloListNotificationTypes executed");
+            const response = await listZudelloNotificationTypes(authContext);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to list notification types");
+            }
+            const types = response.data || [];
+            // Group by category for easier navigation
+            const groupedTypes = {};
+            for (const type of types) {
+                if (!groupedTypes[type.group]) {
+                    groupedTypes[type.group] = [];
+                }
+                groupedTypes[type.group].push(type);
+            }
+            return {
+                success: true,
+                notificationTypes: types,
+                byGroup: groupedTypes,
+                count: types.length,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloListNotificationTypes error", {}, error);
+            return {
+                success: false,
+                error: error.message,
+                notificationTypes: [],
+            };
+        }
+    },
+};
+//# sourceMappingURL=list-notification-types.js.map

package/dist/tools/notifications/list-notification-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-notification-types.js","sourceRoot":"","sources":["../../../src/tools/notifications/list-notification-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAG/E,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE;;;;;;;;;;;;;sFAauE;IACpF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;KACf;IACD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAE,WAAwB,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAEtD,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC,WAAW,CAAC,CAAC;YAEjE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,mCAAmC,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YAElC,0CAA0C;YAC1C,MAAM,YAAY,GAAiC,EAAE,CAAC;YACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC9B,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;gBAChC,CAAC;gBACD,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,iBAAiB,EAAE,KAAK;gBACxB,OAAO,EAAE,YAAY;gBACrB,KAAK,EAAE,KAAK,CAAC,MAAM;aACpB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,iBAAiB,EAAE,EAAE;aACtB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}