@hauptsache.net/clickup-mcp 1.1.0 → 1.2.0

package/README.md

@@ -157,10 +157,15 @@ Add the mode to your MCP configuration:
 
 This MCP server can be configured using environment variables:
 
+### ⚠️ Breaking Changes for v1.2.0+
+- **Image Response Size Limiting**: A new `MAX_RESPONSE_SIZE_MB` environment variable (default: 1MB) may cause existing tasks with large images to display fewer images than before. To restore previous behavior, set `MAX_RESPONSE_SIZE_MB=10` (or higher) in your environment.
+- **Enhanced API Rate Limiting**: The search indexing now uses more conservative API call patterns to prevent rate limit exhaustion. Large workspaces may experience slightly slower initial search index building.
+
 - `CLICKUP_API_KEY`: (Required) Your ClickUp API key.
 - `CLICKUP_TEAM_ID`: (Required) Your ClickUp Team ID (formerly Workspace ID).
 - `CLICKUP_MCP_MODE`: (Optional) Controls which tools are available. Options: `read-minimal`, `read`, `write` (default).
 - `MAX_IMAGES`: (Optional) The maximum number of images to return for a task in `getTaskById`. Defaults to 4.
+- `MAX_RESPONSE_SIZE_MB`: (Optional) The maximum response size in megabytes for `getTaskById`. Uses intelligent size budgeting to fit the most important images within the limit. Defaults to 1.
 - `CLICKUP_PRIMARY_LANGUAGE`: (Optional) A hint for the primary language used in your ClickUp tasks (e.g., "de" for German, "en" for English). This helps the `searchTask` tool provide more tailored guidance in its description for multilingual searches.
 - `LANG`: (Optional) If `CLICKUP_PRIMARY_LANGUAGE` is not set, the MCP will check this standard environment variable (e.g., "en_US.UTF-8", "de_DE") as a fallback to infer the primary language.
 
@@ -219,7 +224,7 @@ This ensures no existing content is ever lost while maintaining a clear audit tr
 ## Performance & Limitations
 
 **Optimized for AI Workflows:**
-- **Image Processing**: Limited to 4 most recent images per task to prevent running into mcp client limitations (configurable via `MAX_IMAGES`)
+- **Smart Image Processing**: Intelligent size budgeting prioritizes the most recent images while respecting both count (`MAX_IMAGES`, default: 4) and total response size limits (`MAX_RESPONSE_SIZE_MB`, default: 1MB)
 - **Search Scope**: Searches within the most recent 1000-3000 tasks to prevent running into rate limits (exact number varies by endpoint)
 - **Search Results**: Returns up to 50 most relevant matches to prevent flooding the agent with too many results
 

package/dist/cli.js

@@ -90,6 +90,7 @@ async function main() {
         // Call the tool's callback function
         const result = await tool.callback(params);
         console.dir(result.content);
+        process.exit(0);
     }
     catch (error) {
         if (error instanceof Error) {

package/dist/clickup-text.d.ts

@@ -1,4 +1,5 @@
 import { CallToolResult } from "@modelcontextprotocol/sdk/types";
+import { ImageMetadataBlock } from "./shared/types";
 /**
  * Represents a ClickUp text item which can be plain text or an image
  */
@@ -24,6 +25,8 @@ export interface ClickUpTextItem {
  */
 export interface ClickUpAttachment {
     thumbnail_large?: string;
+    thumbnail_medium?: string;
+    thumbnail_small?: string;
     url: string;
     [key: string]: any;
 }
@@ -34,12 +37,12 @@ export interface ClickUpAttachment {
  * @param textItems Array of text items from ClickUp API
  * @returns Promise resolving to an array of content blocks (text and images)
  */
-export declare function processClickUpText(textItems: ClickUpTextItem[]): Promise<CallToolResult["content"]>;
+export declare function processClickUpText(textItems: ClickUpTextItem[]): Promise<(CallToolResult["content"][number] | ImageMetadataBlock)[]>;
 /**
  * Splits markdown text at image references and converts them to image blocks
  * @param markdownText The markdown text to process
  * @param attachments Array of attachments from the Clickup API
  * @returns Array of content blocks (text and images)
  */
-export declare function processClickUpMarkdown(markdownText: string, attachments: ClickUpAttachment[]): Promise<CallToolResult["content"]>;
+export declare function processClickUpMarkdown(markdownText: string, attachments: ClickUpAttachment[]): (CallToolResult["content"][number] | ImageMetadataBlock)[];
 //# sourceMappingURL=clickup-text.d.ts.map

package/dist/clickup-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clickup-text.d.ts","sourceRoot":"","sources":["../src/clickup-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,eAAe,EAAE,GAC3B,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAqDpC;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,iBAAiB,EAAE,GAC/B,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAsEpC"}
+{"version":3,"file":"clickup-text.d.ts","sourceRoot":"","sources":["../src/clickup-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AA4BD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,eAAe,EAAE,GAC3B,OAAO,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAiErE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,iBAAiB,EAAE,GAC/B,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAqG5D"}

package/dist/clickup-text.js

@@ -2,7 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.processClickUpText = processClickUpText;
 exports.processClickUpMarkdown = processClickUpMarkdown;
-const buffer_1 = require("buffer");
+/**
+ * Extract thumbnail URLs from data-attachment attribute JSON
+ * ClickUp API sometimes has broken thumbnail URLs, but data-attachment contains working ones
+ */
+function extractThumbnailsFromDataAttachment(attributes) {
+    if (!attributes || !attributes['data-attachment']) {
+        return {};
+    }
+    try {
+        const attachmentData = JSON.parse(attributes['data-attachment']);
+        return {
+            thumbnail_large: attachmentData.thumbnail_large,
+            thumbnail_medium: attachmentData.thumbnail_medium,
+            thumbnail_small: attachmentData.thumbnail_small,
+        };
+    }
+    catch (error) {
+        console.error('Error parsing data-attachment:', error);
+        return {};
+    }
+}
 /**
  * Process an array of ClickUp text items into a structured content format
  * that includes both text and images in their original sequence
@@ -16,23 +36,37 @@ async function processClickUpText(textItems) {
     for (let i = 0; i < textItems.length; i++) {
         const item = textItems[i];
         // Handle image items
-        if (item.type === "image" && item.image && item.image.thumbnail_large) {
-            // If we have accumulated text, add it as a text block before adding the image
-            if (currentTextBlock.trim()) {
-                contentBlocks.push(Promise.resolve({
-                    type: "text",
-                    text: currentTextBlock.trim(),
-                }));
-            }
-            // Reset current text block after pushing it
-            currentTextBlock = "";
-            // Add this image as an image block
-            if (typeof item.image.thumbnail_large === "string") {
-                contentBlocks.push(loadImageContentBlock(item.image.thumbnail_large, {
-                    type: "text",
-                    text: item.text || "Image",
-                }));
+        if (item.type === "image" && item.image && item.image.url) {
+            // Add image URL reference inline to current text block
+            const imageFileName = item.image.name || item.image.title || "image";
+            currentTextBlock += `\nImage: ${imageFileName} - ${item.image.url}`;
+            // Get working thumbnail URLs from data-attachment if available
+            const extractedThumbnails = extractThumbnailsFromDataAttachment(item.attributes);
+            // Determine best thumbnail URLs (prefer extracted over API thumbnails)
+            const thumbnail_large = extractedThumbnails.thumbnail_large || item.image.thumbnail_large;
+            const thumbnail_medium = extractedThumbnails.thumbnail_medium || item.image.thumbnail_medium;
+            const thumbnail_small = extractedThumbnails.thumbnail_small || item.image.thumbnail_small;
+            // Only create image_metadata if we have at least one thumbnail (never use original image)
+            if (thumbnail_large || thumbnail_medium || thumbnail_small) {
+                // Push accumulated text (including image URL) as a text block
+                if (currentTextBlock.trim()) {
+                    contentBlocks.push({
+                        type: "text",
+                        text: currentTextBlock.trim(),
+                    });
+                }
+                // Reset current text block after pushing it
+                currentTextBlock = "";
+                // Create URLs array with largest to smallest preference, filter out undefined
+                const urls = [thumbnail_large, thumbnail_medium, thumbnail_small].filter(Boolean);
+                // Add image_metadata block for lazy loading
+                contentBlocks.push({
+                    type: "image_metadata",
+                    urls: urls,
+                    alt: item.text || imageFileName,
+                });
             }
+            // If no thumbnails, just treat as a file reference (already added to currentTextBlock)
         }
         // Handle text items
         else if (typeof item.text === "string") {
@@ -45,12 +79,12 @@ async function processClickUpText(textItems) {
     }
     // Add any remaining text
     if (currentTextBlock.trim()) {
-        contentBlocks.push(Promise.resolve({
+        contentBlocks.push({
             type: "text",
             text: currentTextBlock.trim(),
-        }));
+        });
     }
-    return Promise.all(contentBlocks);
+    return contentBlocks;
 }
 /**
  * Splits markdown text at image references and converts them to image blocks
@@ -58,15 +92,13 @@ async function processClickUpText(textItems) {
  * @param attachments Array of attachments from the Clickup API
  * @returns Array of content blocks (text and images)
  */
-async function processClickUpMarkdown(markdownText, attachments) {
+function processClickUpMarkdown(markdownText, attachments) {
     const contentBlocks = [];
     let currentTextBlock = "";
-    // Create a map of attachment URLs to their thumbnail_large URLs for easy lookup
-    const thumbnailMap = new Map();
+    // Create a map of attachment URLs to their full info for easy lookup
+    const attachmentMap = new Map();
     for (const attachment of attachments) {
-        if (typeof attachment.thumbnail_large === "string") {
-            thumbnailMap.set(attachment.url, attachment.thumbnail_large);
-        }
+        attachmentMap.set(attachment.url, attachment);
     }
     // Regular expression to match markdown image syntax: ![alt text](url)
     const imageRegex = /!\[([^\]]*)\]\(([^\)]+)\)/g;
@@ -77,59 +109,95 @@ async function processClickUpMarkdown(markdownText, attachments) {
         // Add text before the image reference to the current text block
         currentTextBlock += markdownText.substring(lastIndex, match.index);
         // Check if this image URL exists in our attachments
-        const thumbnailUrl = thumbnailMap.get(imageUrl);
-        if (thumbnailUrl) {
-            // If we have accumulated text, add it as a text block before adding the image
-            if (currentTextBlock.trim()) {
-                contentBlocks.push(Promise.resolve({
-                    type: "text",
-                    text: currentTextBlock.trim(),
-                }));
+        const attachment = attachmentMap.get(imageUrl);
+        if (attachment) {
+            // Add image URL reference inline to current text block
+            const imageFileName = altText || "image";
+            currentTextBlock += `\nImage: ${imageFileName} - ${imageUrl}`;
+            // Only create image_metadata if we have at least one thumbnail (never use original image)
+            if (attachment.thumbnail_large || attachment.thumbnail_medium || attachment.thumbnail_small) {
+                // Push accumulated text (including image URL) as a text block
+                if (currentTextBlock.trim()) {
+                    contentBlocks.push({
+                        type: "text",
+                        text: currentTextBlock.trim(),
+                    });
+                }
+                // Reset current text block after pushing it
+                currentTextBlock = "";
+                // Create URLs array with largest to smallest preference, filter out undefined
+                const urls = [attachment.thumbnail_large, attachment.thumbnail_medium, attachment.thumbnail_small].filter(Boolean);
+                // Add image_metadata block for lazy loading
+                contentBlocks.push({
+                    type: "image_metadata",
+                    urls: urls,
+                    alt: altText || imageFileName,
+                });
             }
-            // Reset current text block after pushing it
-            currentTextBlock = "";
-            // Add this image as an image block
-            contentBlocks.push(loadImageContentBlock(thumbnailUrl, {
-                type: "text",
-                text: fullMatch.trim(),
-            }));
+            // If no thumbnails, just treat as a file reference (already added to currentTextBlock)
         }
         else {
             // If the image URL doesn't match any attachment, keep the original markdown in the current text block
             currentTextBlock += fullMatch;
-            console.error(`Image URL ${imageUrl} not found in attachments`, thumbnailMap);
+            console.error(`Image URL ${imageUrl} not found in attachments`, attachmentMap);
         }
         lastIndex = match.index + fullMatch.length;
     }
     // Add any remaining text after the last image
     currentTextBlock += markdownText.substring(lastIndex);
+    // Process non-image attachments that weren't referenced in markdown
+    const referencedUrls = new Set();
+    const imageMatches = markdownText.matchAll(/!\[([^\]]*)\]\(([^\)]+)\)/g);
+    for (const match of imageMatches) {
+        referencedUrls.add(match[2]);
+    }
+    // Add non-image files inline to the current text block
+    for (const attachment of attachments) {
+        if (!referencedUrls.has(attachment.url)) {
+            // Determine if this is an image based on URL or type
+            const isImage = attachment.thumbnail_large ||
+                /\.(jpg|jpeg|png|gif|webp|svg)$/i.test(attachment.url);
+            if (!isImage) {
+                // This is a non-image file - add inline to current text block
+                const fileName = extractFileNameFromUrl(attachment.url) || "file";
+                const fileType = extractFileTypeFromUrl(attachment.url);
+                const fileTypeText = fileType ? ` (${fileType.toUpperCase()})` : "";
+                currentTextBlock += `\nFile: ${fileName}${fileTypeText} - ${attachment.url}`;
+            }
+        }
+    }
+    // Add any remaining text (including file references) as final text block
     if (currentTextBlock.trim()) {
-        contentBlocks.push(Promise.resolve({
+        contentBlocks.push({
             type: "text",
             text: currentTextBlock.trim(),
-        }));
+        });
     }
-    return Promise.all(contentBlocks);
+    return contentBlocks;
 }
 /**
- * Loads an image from a URL and converts it to a base64-encoded content block
- *
- * @param url URL of the image to load
- * @param fallback Fallback content if image loading fails
- * @returns Promise resolving to a content block (either image or fallback text)
+ * Extract filename from URL
  */
-async function loadImageContentBlock(url, fallback) {
+function extractFileNameFromUrl(url) {
     try {
-        const response = await fetch(url);
-        const imageBuffer = await response.arrayBuffer();
-        return {
-            type: "image",
-            mimeType: response.headers.get("Content-Type") || "image/png",
-            data: buffer_1.Buffer.from(imageBuffer).toString("base64"),
-        };
+        const urlObj = new URL(url);
+        const pathname = urlObj.pathname;
+        const filename = pathname.split('/').pop();
+        return filename && filename !== '' ? filename : null;
     }
-    catch (error) {
-        console.error(`Error fetching image: ${error.message || "Unknown error"}`);
-        return fallback;
+    catch {
+        return null;
     }
 }
+/**
+ * Extract file extension from URL
+ */
+function extractFileTypeFromUrl(url) {
+    const filename = extractFileNameFromUrl(url);
+    if (!filename)
+        return null;
+    const lastDot = filename.lastIndexOf('.');
+    if (lastDot === -1)
+        return null;
+    return filename.substring(lastDot + 1);
+}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE,QAAA,MAAM,MAAM,WAGV,CAAC;AAsCH,QAAA,MAAM,aAAa,oBAAqB,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE,QAAA,MAAM,MAAM,WAGV,CAAC;AAsCH,QAAA,MAAM,aAAa,oBAAqB,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC"}

package/dist/index.js

@@ -8,6 +8,7 @@ const config_1 = require("./shared/config");
 const utils_1 = require("./shared/utils");
 // Import tool registration functions
 const task_tools_1 = require("./tools/task-tools");
+const task_write_tools_1 = require("./tools/task-write-tools");
 const search_tools_1 = require("./tools/search-tools");
 const space_tools_1 = require("./tools/space-tools");
 const list_tools_1 = require("./tools/list-tools");
@@ -15,7 +16,7 @@ const time_tools_1 = require("./tools/time-tools");
 // Create an MCP server
 const server = new mcp_js_1.McpServer({
     name: "Clickup MCP",
-    version: "1.0.0",
+    version: require('../package.json').version,
 });
 exports.server = server;
 // Register tools based on mode with user data for enhanced documentation
@@ -28,12 +29,12 @@ async function initializeServer() {
         // Core task context tools for AI coding assistance
         // Only getTaskById and searchTasks
         (0, task_tools_1.registerTaskToolsRead)(server, userData);
-        (0, search_tools_1.registerSearchTools)(server);
+        (0, search_tools_1.registerSearchTools)(server, userData);
     }
     else if (config_1.CONFIG.mode === 'read') {
         // All read-only tools
         (0, task_tools_1.registerTaskToolsRead)(server, userData);
-        (0, search_tools_1.registerSearchTools)(server);
+        (0, search_tools_1.registerSearchTools)(server, userData);
         (0, space_tools_1.registerSpaceTools)(server);
         (0, list_tools_1.registerListToolsRead)(server);
         (0, time_tools_1.registerTimeToolsRead)(server);
@@ -41,8 +42,8 @@ async function initializeServer() {
     else if (config_1.CONFIG.mode === 'write') {
         // All tools (full functionality)
         (0, task_tools_1.registerTaskToolsRead)(server, userData);
-        (0, task_tools_1.registerTaskToolsWrite)(server, userData);
-        (0, search_tools_1.registerSearchTools)(server);
+        (0, task_write_tools_1.registerTaskToolsWrite)(server, userData);
+        (0, search_tools_1.registerSearchTools)(server, userData);
         (0, space_tools_1.registerSpaceTools)(server);
         (0, list_tools_1.registerListToolsRead)(server);
         (0, list_tools_1.registerListToolsWrite)(server);

package/dist/shared/config.d.ts

@@ -4,6 +4,7 @@ export declare const CONFIG: {
     apiKey: string;
     teamId: string;
     maxImages: number;
+    maxResponseSizeMB: number;
     primaryLanguageHint: string | undefined;
     mode: McpMode;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,oBAA2D,CAAC;AAavF,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AAUxD,eAAO,MAAM,MAAM;;;;;;CAMlB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,oBAA2D,CAAC;AAavF,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AAUxD,eAAO,MAAM,MAAM;;;;;;;CAOlB,CAAC"}

package/dist/shared/config.js

@@ -23,6 +23,7 @@ exports.CONFIG = {
     apiKey: process.env.CLICKUP_API_KEY,
     teamId: process.env.CLICKUP_TEAM_ID,
     maxImages: process.env.MAX_IMAGES ? parseInt(process.env.MAX_IMAGES) : 4,
+    maxResponseSizeMB: process.env.MAX_RESPONSE_SIZE_MB ? parseFloat(process.env.MAX_RESPONSE_SIZE_MB) : 1,
     primaryLanguageHint: detectedLanguageHint, // Store the cleaned code directly
     mode: mcpMode,
 };

package/dist/shared/image-processing.d.ts

@@ -0,0 +1,13 @@
+import { ContentBlock, ImageMetadataBlock } from "./types";
+/**
+ * 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
+ */
+export declare function downloadImages(content: (ContentBlock | ImageMetadataBlock)[], maxImages?: number, maxSizeMB?: number): Promise<ContentBlock[]>;
+//# sourceMappingURL=image-processing.d.ts.map

package/dist/shared/image-processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-processing.d.ts","sourceRoot":"","sources":["../../src/shared/image-processing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAIzD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,CAAC,YAAY,GAAG,kBAAkB,CAAC,EAAE,EAAE,SAAS,GAAE,MAAyB,EAAE,SAAS,GAAE,MAAiC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAwBhM"}

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"}