@hauptsache.net/clickup-mcp 1.1.0 → 1.2.0

package/dist/shared/utils.d.ts

@@ -1,4 +1,3 @@
-import { ContentBlock } from "./types";
 import Fuse from 'fuse.js';
 /**
  * Checks if a string looks like a valid ClickUp task ID
@@ -7,24 +6,76 @@ import Fuse from 'fuse.js';
 export declare function isTaskId(str: string): boolean;
 /**
  * Get current authenticated user information from ClickUp API
- * Caches the result after first successful fetch to avoid repeated API calls during the session
+ * Caches the promise to prevent race conditions on concurrent calls
  */
 export declare function getCurrentUser(): Promise<any>;
-/**
- * Limits the number of images in the content array, replacing excess images with text placeholders
- * Prioritizes keeping the most recent images (assumes content is ordered with newest items last)
- *
- * @param content Array of content blocks that may contain images
- * @param maxImages Maximum number of images to keep
- * @returns Modified content array with limited images
- */
-export declare function limitImages(content: ContentBlock[], maxImages: number): ContentBlock[];
+export { downloadImages } from "./image-processing";
 /**
  * Function to get space details, using a cache to avoid redundant fetches
  */
 export declare function getSpaceDetails(spaceId: string): Promise<any>;
 /**
  * Get or create a task search index with specified filters
+ * Caches promises to prevent race conditions on concurrent calls
  */
 export declare function getTaskSearchIndex(space_ids?: string[], list_ids?: string[], assignees?: string[]): Promise<Fuse<any> | null>;
+/**
+ * Generate a ClickUp task URL from a task ID
+ */
+export declare function generateTaskUrl(taskId: string): string;
+/**
+ * Generate a ClickUp list URL from a list ID
+ */
+export declare function generateListUrl(listId: string): string;
+/**
+ * Generate a ClickUp space URL from a space ID
+ */
+export declare function generateSpaceUrl(spaceId: string): string;
+/**
+ * Generate a ClickUp folder URL from a folder ID
+ */
+export declare function generateFolderUrl(folderId: string): string;
+/**
+ * Format a ClickUp task link as markdown
+ */
+export declare function formatTaskLink(taskId: string, taskName?: string): string;
+/**
+ * Format a ClickUp list link as markdown
+ */
+export declare function formatListLink(listId: string, listName?: string): string;
+/**
+ * Format a ClickUp space link as markdown
+ */
+export declare function formatSpaceLink(spaceId: string, spaceName?: string): string;
+/**
+ * Extract task ID from a ClickUp URL
+ */
+export declare function extractTaskIdFromUrl(url: string): string | null;
+/**
+ * Validate if a string is a valid ClickUp URL
+ */
+export declare function isClickUpUrl(url: string): boolean;
+/**
+ * Format a prominent link section for responses
+ */
+export declare function formatLinksSection(links: {
+    text: string;
+    url: string;
+}[]): string;
+/**
+ * Get or refresh the space search index
+ * Caches promise to prevent race conditions on concurrent calls
+ */
+export declare function getSpaceSearchIndex(): Promise<Fuse<any> | null>;
+/**
+ * Get lists and folders for a specific space with caching
+ */
+export declare function getSpaceContent(spaceId: string): Promise<{
+    lists: any[];
+    folders: any[];
+}>;
+/**
+ * Gets all team members from ClickUp API with caching
+ */
+export declare function getAllTeamMembers(): Promise<string[]>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/shared/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AAErC,OAAO,IAAI,MAAM,SAAS,CAAC;AAI3B;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG7C;AAKD;;;GAGG;AACH,wBAAsB,cAAc,iBAiBnC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CA8BtF;AAID;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CA0B7D;AAKD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CA4B3B"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAEA,OAAO,IAAI,MAAM,SAAS,CAAC;AAI3B;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG7C;AAKD;;;GAGG;AACH,wBAAsB,cAAc,iBA6BnC;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CA0B7D;AAKD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CA+B3B;AAiED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAKjF;AAKD;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CA+CrE;AAKD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,CAgEhG;AAKD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA+C3D"}

package/dist/shared/utils.js

@@ -3,11 +3,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadImages = void 0;
 exports.isTaskId = isTaskId;
 exports.getCurrentUser = getCurrentUser;
-exports.limitImages = limitImages;
 exports.getSpaceDetails = getSpaceDetails;
 exports.getTaskSearchIndex = getTaskSearchIndex;
+exports.generateTaskUrl = generateTaskUrl;
+exports.generateListUrl = generateListUrl;
+exports.generateSpaceUrl = generateSpaceUrl;
+exports.generateFolderUrl = generateFolderUrl;
+exports.formatTaskLink = formatTaskLink;
+exports.formatListLink = formatListLink;
+exports.formatSpaceLink = formatSpaceLink;
+exports.extractTaskIdFromUrl = extractTaskIdFromUrl;
+exports.isClickUpUrl = isClickUpUrl;
+exports.formatLinksSection = formatLinksSection;
+exports.getSpaceSearchIndex = getSpaceSearchIndex;
+exports.getSpaceContent = getSpaceContent;
+exports.getAllTeamMembers = getAllTeamMembers;
 const config_1 = require("./config");
 const fuse_js_1 = __importDefault(require("fuse.js"));
 const GLOBAL_REFRESH_INTERVAL = 60000; // 60 seconds - that is the rate limit time frame
@@ -19,62 +32,39 @@ function isTaskId(str) {
     // Task IDs are 6-9 characters long and contain only alphanumeric characters
     return /^[a-z0-9]{6,9}$/i.test(str);
 }
-// Cache for current user info to avoid repeated API calls
-let cachedUserData = null;
+// Cache for current user info to avoid repeated API calls and race conditions
+let cachedUserPromise = null;
 /**
  * Get current authenticated user information from ClickUp API
- * Caches the result after first successful fetch to avoid repeated API calls during the session
+ * Caches the promise to prevent race conditions on concurrent calls
  */
 async function getCurrentUser() {
-    // Return cached data if available
-    if (cachedUserData) {
-        return cachedUserData;
+    // Return cached promise if available
+    if (cachedUserPromise) {
+        return cachedUserPromise;
     }
-    const userResponse = await fetch("https://api.clickup.com/api/v2/user", {
-        headers: { Authorization: config_1.CONFIG.apiKey },
-    });
-    if (!userResponse.ok) {
-        throw new Error(`Error fetching user info: ${userResponse.status} ${userResponse.statusText}`);
-    }
-    // Cache the result for future calls
-    cachedUserData = await userResponse.json();
-    return cachedUserData;
-}
-/**
- * Limits the number of images in the content array, replacing excess images with text placeholders
- * Prioritizes keeping the most recent images (assumes content is ordered with newest items last)
- *
- * @param content Array of content blocks that may contain images
- * @param maxImages Maximum number of images to keep
- * @returns Modified content array with limited images
- */
-function limitImages(content, maxImages) {
-    // Count how many images we have
-    const imageIndices = [];
-    // Find all image blocks
-    content.forEach((block, index) => {
-        if (block.type === "image") {
-            imageIndices.push(index);
-        }
-    });
-    // If we have fewer images than the limit, return the original content
-    if (imageIndices.length <= maxImages) {
-        return content;
-    }
-    // Determine which images to keep (the most recent ones)
-    // We want to keep the last 'maxImages' images
-    const imagesToRemove = imageIndices.slice(0, imageIndices.length - maxImages);
-    // Create a new content array with excess images replaced by text
-    return content.map((block, index) => {
-        if (block.type === "image" && imagesToRemove.includes(index)) {
-            return {
-                type: "text",
-                text: "[Image removed due to size limitations. Only the most recent images are shown.]",
-            };
+    // Create the fetch promise
+    const fetchPromise = (async () => {
+        const userResponse = await fetch("https://api.clickup.com/api/v2/user", {
+            headers: { Authorization: config_1.CONFIG.apiKey },
+        });
+        if (!userResponse.ok) {
+            throw new Error(`Error fetching user info: ${userResponse.status} ${userResponse.statusText}`);
         }
-        return block;
-    });
+        return await userResponse.json();
+    })();
+    // Cache the promise
+    cachedUserPromise = fetchPromise;
+    // Auto-cleanup after 60 seconds
+    setTimeout(() => {
+        cachedUserPromise = null;
+        console.error(`Auto-cleaned user data cache`);
+    }, GLOBAL_REFRESH_INTERVAL);
+    return fetchPromise;
 }
+// Re-export image processing functions for backward compatibility
+var image_processing_1 = require("./image-processing");
+Object.defineProperty(exports, "downloadImages", { enumerable: true, get: function () { return image_processing_1.downloadImages; } });
 const spaceCache = new Map(); // Global cache for space details promises
 /**
  * Function to get space details, using a cache to avoid redundant fetches
@@ -101,10 +91,11 @@ function getSpaceDetails(spaceId) {
     spaceCache.set(spaceId, fetchPromise);
     return fetchPromise;
 }
-// Task search index management
+// Task search index management - cache promises to prevent race conditions
 const taskIndices = new Map();
 /**
  * Get or create a task search index with specified filters
+ * Caches promises to prevent race conditions on concurrent calls
  */
 async function getTaskSearchIndex(space_ids, list_ids, assignees) {
     // Create cache key from sorted filter arrays
@@ -113,23 +104,26 @@ async function getTaskSearchIndex(space_ids, list_ids, assignees) {
         list_ids: list_ids?.sort(),
         assignees: assignees?.sort()
     });
-    // Check for existing valid index
-    const cachedIndex = taskIndices.get(key);
-    if (cachedIndex) {
-        return cachedIndex;
+    // Check for existing valid index promise
+    const cachedPromise = taskIndices.get(key);
+    if (cachedPromise) {
+        return cachedPromise;
     }
-    // Fetch tasks with specified filters
-    console.error(`Refreshing task index for filters: ${key}`);
-    const tasks = await fetchTasks(space_ids, list_ids, assignees);
-    const index = createFuseIndex(tasks);
-    // Store with auto-cleanup
-    taskIndices.set(key, index);
+    // Create the fetch promise
+    const fetchPromise = (async () => {
+        console.error(`Refreshing task index for filters: ${key}`);
+        const tasks = await fetchTasks(space_ids, list_ids, assignees);
+        const index = createFuseIndex(tasks);
+        console.error(`Task index created with ${tasks.length} tasks`);
+        return index;
+    })();
+    // Store promise with auto-cleanup
+    taskIndices.set(key, fetchPromise);
     setTimeout(() => {
         taskIndices.delete(key);
         console.error(`Auto-cleaned index for filters: ${key}`);
     }, GLOBAL_REFRESH_INTERVAL);
-    console.error(`Task index created with ${tasks.length} tasks`);
-    return index;
+    return fetchPromise;
 }
 /**
  * Fetch tasks using team endpoint with dynamic filters
@@ -183,3 +177,227 @@ function createFuseIndex(tasks) {
         minMatchCharLength: 2,
     });
 }
+// ===== LINK UTILITIES =====
+/**
+ * Generate a ClickUp task URL from a task ID
+ */
+function generateTaskUrl(taskId) {
+    return `https://app.clickup.com/t/${taskId}`;
+}
+/**
+ * Generate a ClickUp list URL from a list ID
+ */
+function generateListUrl(listId) {
+    return `https://app.clickup.com/v/l/${listId}`;
+}
+/**
+ * Generate a ClickUp space URL from a space ID
+ */
+function generateSpaceUrl(spaceId) {
+    return `https://app.clickup.com/v/s/${spaceId}`;
+}
+/**
+ * Generate a ClickUp folder URL from a folder ID
+ */
+function generateFolderUrl(folderId) {
+    return `https://app.clickup.com/v/f/${folderId}`;
+}
+/**
+ * Format a ClickUp task link as markdown
+ */
+function formatTaskLink(taskId, taskName) {
+    const url = generateTaskUrl(taskId);
+    const displayText = taskName ? `${taskName} (${taskId})` : taskId;
+    return `[${displayText}](${url})`;
+}
+/**
+ * Format a ClickUp list link as markdown
+ */
+function formatListLink(listId, listName) {
+    const url = generateListUrl(listId);
+    const displayText = listName ? `${listName} (${listId})` : listId;
+    return `[${displayText}](${url})`;
+}
+/**
+ * Format a ClickUp space link as markdown
+ */
+function formatSpaceLink(spaceId, spaceName) {
+    const url = generateSpaceUrl(spaceId);
+    const displayText = spaceName ? `${spaceName} (${spaceId})` : spaceId;
+    return `[${displayText}](${url})`;
+}
+/**
+ * Extract task ID from a ClickUp URL
+ */
+function extractTaskIdFromUrl(url) {
+    const match = url.match(/https?:\/\/app\.clickup\.com\/t\/([a-z0-9]{6,9})/i);
+    return match ? match[1] : null;
+}
+/**
+ * Validate if a string is a valid ClickUp URL
+ */
+function isClickUpUrl(url) {
+    return /^https?:\/\/app\.clickup\.com\//.test(url);
+}
+/**
+ * Format a prominent link section for responses
+ */
+function formatLinksSection(links) {
+    if (links.length === 0)
+        return '';
+    const linkLines = links.map(link => `🔗 [${link.text}](${link.url})`);
+    return `\n\n**📌 Quick Links:**\n${linkLines.join('\n')}`;
+}
+// Space search index cache - cache promise to prevent race conditions
+let spaceSearchIndexPromise = null;
+/**
+ * Get or refresh the space search index
+ * Caches promise to prevent race conditions on concurrent calls
+ */
+async function getSpaceSearchIndex() {
+    // Return cached promise if available
+    if (spaceSearchIndexPromise) {
+        return spaceSearchIndexPromise;
+    }
+    // Create the fetch promise
+    const fetchPromise = (async () => {
+        try {
+            const url = `https://api.clickup.com/api/v2/team/${config_1.CONFIG.teamId}/space`;
+            const response = await fetch(url, {
+                headers: { Authorization: config_1.CONFIG.apiKey },
+            });
+            if (!response.ok) {
+                throw new Error(`Error fetching spaces: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            const spacesData = data.spaces || [];
+            // Create Fuse search index
+            return new fuse_js_1.default(spacesData, {
+                keys: [
+                    { name: 'name', weight: 0.7 },
+                    { name: 'id', weight: 0.6 }
+                ],
+                includeScore: true,
+                threshold: 0.4,
+                minMatchCharLength: 1,
+            });
+        }
+        catch (error) {
+            console.error('Error creating space search index:', error);
+            return null;
+        }
+    })();
+    // Cache the promise
+    spaceSearchIndexPromise = fetchPromise;
+    // Auto-cleanup after 60 seconds
+    setTimeout(() => {
+        spaceSearchIndexPromise = null;
+        console.error('Auto-cleaned space search index');
+    }, GLOBAL_REFRESH_INTERVAL);
+    return fetchPromise;
+}
+const listCache = new Map(); // Cache for space lists/folders
+/**
+ * Get lists and folders for a specific space with caching
+ */
+async function getSpaceContent(spaceId) {
+    const cacheKey = `space-content-${spaceId}`;
+    // Check cache first
+    const cachedContent = listCache.get(cacheKey);
+    if (cachedContent) {
+        return cachedContent;
+    }
+    // Fetch content with parallel requests
+    const fetchPromise = (async () => {
+        try {
+            const [foldersResponse, listsResponse] = await Promise.all([
+                fetch(`https://api.clickup.com/api/v2/space/${spaceId}/folder`, {
+                    headers: { Authorization: config_1.CONFIG.apiKey },
+                }),
+                fetch(`https://api.clickup.com/api/v2/space/${spaceId}/list`, {
+                    headers: { Authorization: config_1.CONFIG.apiKey },
+                })
+            ]);
+            const folders = foldersResponse.ok ?
+                (await foldersResponse.json()).folders || [] : [];
+            const lists = listsResponse.ok ?
+                (await listsResponse.json()).lists || [] : [];
+            // For each folder, also fetch its lists
+            const folderListPromises = folders.map(async (folder) => {
+                try {
+                    const folderListResponse = await fetch(`https://api.clickup.com/api/v2/folder/${folder.id}/list`, { headers: { Authorization: config_1.CONFIG.apiKey } });
+                    if (folderListResponse.ok) {
+                        const folderListData = await folderListResponse.json();
+                        folder.lists = folderListData.lists || [];
+                    }
+                    return folder;
+                }
+                catch (error) {
+                    console.error(`Error fetching lists for folder ${folder.id}:`, error);
+                    folder.lists = [];
+                    return folder;
+                }
+            });
+            const foldersWithLists = await Promise.all(folderListPromises);
+            return { lists, folders: foldersWithLists };
+        }
+        catch (error) {
+            console.error(`Error fetching space content for ${spaceId}:`, error);
+            return { lists: [], folders: [] };
+        }
+    })();
+    // Cache the promise
+    listCache.set(cacheKey, fetchPromise);
+    // Auto-cleanup after 60 seconds
+    setTimeout(() => {
+        listCache.delete(cacheKey);
+        console.error(`Auto-cleaned space content cache for ${spaceId}`);
+    }, GLOBAL_REFRESH_INTERVAL);
+    return fetchPromise;
+}
+// Cache for team members to avoid repeated API calls and race conditions
+let cachedTeamMembersPromise = null;
+/**
+ * Gets all team members from ClickUp API with caching
+ */
+async function getAllTeamMembers() {
+    // Return cached promise if available
+    if (cachedTeamMembersPromise) {
+        return cachedTeamMembersPromise;
+    }
+    // Create the fetch promise
+    const fetchPromise = (async () => {
+        try {
+            const response = await fetch(`https://api.clickup.com/api/v2/team`, {
+                headers: { Authorization: config_1.CONFIG.apiKey },
+            });
+            if (!response.ok) {
+                console.error(`Error fetching teams: ${response.status} ${response.statusText}`);
+                return [];
+            }
+            const data = await response.json();
+            if (!data.teams || !Array.isArray(data.teams)) {
+                return [];
+            }
+            // Find the team that matches our configured team ID and extract all user IDs
+            const currentTeam = data.teams.find((team) => team.id === config_1.CONFIG.teamId);
+            if (!currentTeam || !currentTeam.members || !Array.isArray(currentTeam.members)) {
+                console.error(`Team ${config_1.CONFIG.teamId} not found or has no members`);
+                return [];
+            }
+            return currentTeam.members.map((member) => member.user?.id).filter(Boolean);
+        }
+        catch (error) {
+            console.error('Error fetching team members:', error);
+            return [];
+        }
+    })();
+    // Cache the promise
+    cachedTeamMembersPromise = fetchPromise;
+    // Auto-cleanup after 60 seconds
+    setTimeout(() => {
+        cachedTeamMembersPromise = null;
+        console.error(`Auto-cleaned team members cache`);
+    }, GLOBAL_REFRESH_INTERVAL);
+    return fetchPromise;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"list-tools.d.ts","sourceRoot":"","sources":["../../src/tools/list-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QA4OtD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAuEvD"}
+{"version":3,"file":"list-tools.d.ts","sourceRoot":"","sources":["../../src/tools/list-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QA+GtD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAyEvD"}