@hauptsache.net/clickup-mcp 1.1.1 → 1.3.0

package/dist/shared/image-processing.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadImages = downloadImages;
+const config_1 = require("./config");
+const buffer_1 = require("buffer");
+/**
+ * Downloads images from image_metadata blocks and applies smart size/count limiting
+ * Prioritizes keeping the most recent images (assumes content is ordered with newest items last)
+ * Uses intelligent size calculation accounting for text content
+ *
+ * @param content Array of content blocks that may contain image_metadata blocks
+ * @param maxImages Maximum number of images to keep (defaults to CONFIG.maxImages)
+ * @param maxSizeMB Maximum response size in MB (defaults to CONFIG.maxResponseSizeMB)
+ * @returns Promise resolving to content array with downloaded images or placeholders
+ */
+async function downloadImages(content, maxImages = config_1.CONFIG.maxImages, maxSizeMB = config_1.CONFIG.maxResponseSizeMB) {
+    // First apply count-based limiting to image_metadata blocks
+    const countLimitedContent = applyCountBasedLimitToImageMetadata(content, maxImages);
+    // Calculate text size to determine available image budget
+    const textContent = countLimitedContent.filter(block => block.type !== "image_metadata");
+    const textSizeBytes = JSON.stringify(textContent).length;
+    const maxSizeBytes = maxSizeMB * 1024 * 1024;
+    const availableImageBudget = Math.max(0, maxSizeBytes - textSizeBytes);
+    // Calculate per-image budget
+    const imageMetadataBlocks = countLimitedContent.filter(block => block.type === "image_metadata");
+    const perImageBudget = imageMetadataBlocks.length > 0 ? availableImageBudget / imageMetadataBlocks.length : 0;
+    // Download images in parallel and replace image_metadata blocks
+    const downloadPromises = countLimitedContent.map(async (block) => {
+        if (block.type === "image_metadata") {
+            return await downloadSingleImage(block, perImageBudget);
+        }
+        else {
+            return block;
+        }
+    });
+    return Promise.all(downloadPromises);
+}
+/**
+ * Apply count-based limiting to image_metadata blocks
+ * Keeps the most recent image_metadata blocks (newest last)
+ */
+function applyCountBasedLimitToImageMetadata(content, maxImages) {
+    // Find all image_metadata block indices
+    const imageMetadataIndices = [];
+    content.forEach((block, index) => {
+        if (block.type === "image_metadata") {
+            imageMetadataIndices.push(index);
+        }
+    });
+    // If we have fewer images than the limit, return the original content
+    if (imageMetadataIndices.length <= maxImages) {
+        return content;
+    }
+    // Determine which image_metadata blocks to remove (keep the most recent ones)
+    const imagesToRemove = imageMetadataIndices.slice(0, imageMetadataIndices.length - maxImages);
+    // Create a new content array with excess image_metadata blocks replaced by text placeholders
+    return content.map((block, index) => {
+        if (block.type === "image_metadata" && imagesToRemove.includes(index)) {
+            return {
+                type: "text",
+                text: "[Image removed due to count limitations. Only the most recent images are shown.]",
+            };
+        }
+        return block;
+    });
+}
+/**
+ * Download a single image from an image_metadata block, trying different sizes if needed
+ */
+async function downloadSingleImage(imageMetadata, perImageBudget) {
+    const fallbackText = {
+        type: "text",
+        text: `[Image "${imageMetadata.alt}" removed due to size limitations.]`,
+    };
+    // Try each URL in order (largest to smallest)
+    for (const url of imageMetadata.urls) {
+        const abortController = new AbortController();
+        try {
+            const response = await fetch(url, {
+                signal: abortController.signal
+            });
+            if (!response.ok) {
+                console.error(`Failed to fetch image from ${url}: ${response.status}`);
+                continue;
+            }
+            // Check Content-Length header first to avoid downloading large images
+            const contentLength = response.headers.get("Content-Length");
+            if (contentLength) {
+                const imageSizeBytes = parseInt(contentLength, 10);
+                if (imageSizeBytes > perImageBudget) {
+                    // Cancel the request to stop any ongoing download
+                    abortController.abort();
+                    console.error(`Image from ${url} is ${imageSizeBytes} bytes (from Content-Length), exceeds budget of ${perImageBudget} bytes`);
+                    // Continue to try smaller thumbnail
+                    continue;
+                }
+            }
+            const imageBuffer = await response.arrayBuffer();
+            const actualSizeBytes = imageBuffer.byteLength;
+            // Double-check actual size (in case Content-Length was missing or incorrect)
+            if (actualSizeBytes <= perImageBudget) {
+                return {
+                    type: "image",
+                    mimeType: response.headers.get("Content-Type") || "image/png",
+                    data: buffer_1.Buffer.from(imageBuffer).toString("base64"),
+                };
+            }
+            else {
+                // Cancel to clean up the connection
+                abortController.abort();
+                console.error(`Image from ${url} is ${actualSizeBytes} bytes (actual size), exceeds budget of ${perImageBudget} bytes`);
+                // Continue to try smaller thumbnail
+            }
+        }
+        catch (error) {
+            if (error.name === 'AbortError') {
+                // Request was cancelled, this is expected - continue to next URL
+                continue;
+            }
+            console.error(`Error fetching image from ${url}: ${error.message || "Unknown error"}`);
+            // Continue to try next URL
+        }
+    }
+    // If all URLs failed or were too large, return fallback text
+    return fallbackText;
+}

package/dist/shared/types.d.ts

@@ -1,13 +1,19 @@
 import { CallToolResult } from "@modelcontextprotocol/sdk/types";
 export type ContentBlock = CallToolResult['content'][number];
+export interface ImageMetadataBlock {
+    type: "image_metadata";
+    urls: string[];
+    alt: string;
+}
 export interface DatedContentEvent {
     date: string;
-    contentBlocks: ContentBlock[];
+    contentBlocks: (ContentBlock | ImageMetadataBlock)[];
 }
 export interface Config {
     apiKey: string;
     teamId: string;
     maxImages: number;
+    maxResponseSizeMB: number;
     primaryLanguageHint: string | undefined;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAG7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAGD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAG7D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAGD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,CAAC,YAAY,GAAG,kBAAkB,CAAC,EAAE,CAAC;CACtD;AAGD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC"}

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,17 @@ 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>;
 /**
@@ -44,30 +36,36 @@ export declare function generateSpaceUrl(spaceId: string): string;
  */
 export declare function generateFolderUrl(folderId: string): string;
 /**
- * Format a ClickUp task link as markdown
+ * Generate a ClickUp document URL from a document ID and optional page ID
  */
-export declare function formatTaskLink(taskId: string, taskName?: string): string;
+export declare function generateDocumentUrl(docId: string, pageId?: string): string;
 /**
- * Format a ClickUp list link as markdown
+ * Get or refresh the space search index
+ * Caches promise to prevent race conditions on concurrent calls
  */
-export declare function formatListLink(listId: string, listName?: string): string;
+export declare function getSpaceSearchIndex(): Promise<Fuse<any> | null>;
 /**
- * Format a ClickUp space link as markdown
+ * Get lists, folders, and documents for a specific space with caching
  */
-export declare function formatSpaceLink(spaceId: string, spaceName?: string): string;
+export declare function getSpaceContent(spaceId: string): Promise<{
+    lists: any[];
+    folders: any[];
+    documents: any[];
+}>;
 /**
- * Extract task ID from a ClickUp URL
+ * Gets all team members from ClickUp API with caching
  */
-export declare function extractTaskIdFromUrl(url: string): string | null;
+export declare function getAllTeamMembers(): Promise<string[]>;
 /**
- * Validate if a string is a valid ClickUp URL
+ * Get or create a document search index with space name resolution
+ * Caches promises to prevent race conditions on concurrent calls
  */
-export declare function isClickUpUrl(url: string): boolean;
+export declare function getDocumentSearchIndex(space_ids?: string[]): Promise<Fuse<any> | null>;
 /**
- * Format a prominent link section for responses
+ * Performs multi-term search with aggressive boosting for items matching multiple terms
+ * @param searchIndex Fuse search index to search within
+ * @param terms Array of search terms
+ * @returns Array of items sorted by relevance (multi-term matches ranked higher)
  */
-export declare function formatLinksSection(links: {
-    text: string;
-    url: string;
-}[]): string;
+export declare function performMultiTermSearch<T>(searchIndex: Fuse<T>, terms: string[]): Promise<T[]>;
 //# 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;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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AACA,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;AAkED;;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,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1E;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,CAAC;IAAC,SAAS,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,CAgFlH;AAKD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA+C3D;AAKD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CA6B3B;AAuID;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,CAAC,EAAE,CAAC,CA8Dd"}