@hauptsache.net/clickup-mcp 1.7.0 → 1.7.3

package/README.md

@@ -188,6 +188,7 @@ The ClickUp MCP supports three operational modes to balance functionality, secur
 |------------------------|:------------:|:----:|:-----:|-----------------------------------------------------------------------------------------|
 | `getTaskById`          |      ✅       |  ✅   |   ✅   | Get complete task details including comments, images, and metadata                      |
 | `addComment`           |      ❌       |  ❌   |   ✅   | Add comments to tasks for collaboration                                                 |
+| `editComment`          |      ❌       |  ❌   |   ✅   | Correct your own comment within 24h instead of posting a follow-up                      |
 | `updateTask`           |      ❌       |  ❌   |   ✅   | Update tasks (status, priority, assignees, etc.) with **SAFE APPEND-ONLY** descriptions |
 | `createTask`           |      ❌       |  ❌   |   ✅   | Create new tasks with full markdown support                                             |
 | `searchTasks`          |      ✅       |  ✅   |   ✅   | Find tasks by content, keywords, assignees, or project context                          |
@@ -223,7 +224,7 @@ Add the mode to your MCP configuration:
 
 ## Configuration
 
-This MCP server can be configured using environment variables:
+This MCP server can be configured using environment variables. In the desktop extension (`.mcpb`) installer, the API key, team ID, primary language, upload size limit and comment edit window are offered as form fields; the remaining variables have to be set on the server environment directly.
 
 - `CLICKUP_API_KEY`: (Required) Your ClickUp API key.
 - `CLICKUP_TEAM_ID`: (Required) Your ClickUp Team ID (formerly Workspace ID).
@@ -231,6 +232,7 @@ This MCP server can be configured using environment variables:
 - `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.
 - `MAX_UPLOAD_SIZE_MB`: (Optional) The maximum size of a single image uploaded when writing comments or descriptions. Defaults to 10.
+- `CLICKUP_COMMENT_EDIT_WINDOW_HOURS`: (Optional) How long after creation `editComment` may still rewrite a comment. Defaults to 24. Set to `0` to disable comment editing entirely.
 - `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.
 
@@ -288,7 +290,7 @@ This ensures no existing content is ever lost while maintaining a clear audit tr
 
 ## Writing Images Into Tickets
 
-`addComment`, `createTask` and `updateTask` accept images as ordinary markdown. Because
+`addComment`, `editComment`, `createTask` and `updateTask` accept images as ordinary markdown. Because
 this server runs locally, it reads the file itself - so a **local path is enough**:
 
 ```markdown
@@ -311,8 +313,11 @@ Notes:
 - **An image inside a numbered list breaks ClickUp's numbering.** Write walkthrough
   steps as bold lines with the image between them, as above.
 - Only real PNG/JPEG/GIF/WebP files are uploaded - the content is checked, not the
-  extension. A file that fails is reported in the response, and the comment or task is
-  still written.
+  extension. A file that fails **aborts the write**: `addComment`, `editComment` and
+  `updateTask` report every broken reference and change nothing, so the markdown can be
+  fixed and the call retried without creating duplicates. `createTask` validates its
+  images before creating the task; only an upload failing afterwards is reported as a
+  warning, since the task already exists at that point.
 - Attachments always belong to a task, so document pages cannot embed uploads this way.
 
 ## Performance & Limitations

package/dist/clickup-text.d.ts

@@ -6,6 +6,9 @@ import { ImageMetadataBlock } from "./shared/types";
 export interface ClickUpTextItem {
     text?: string;
     type?: string;
+    task_mention?: {
+        task_id?: string;
+    };
     image?: {
         id?: string;
         name?: string;
@@ -54,6 +57,7 @@ export interface ClickUpCommentBlock {
     attributes?: {
         bold?: boolean;
         italic?: boolean;
+        strike?: boolean;
         code?: boolean;
         link?: string;
         'code-block'?: {
@@ -72,6 +76,13 @@ export interface ClickUpCommentBlock {
     list?: {
         list: 'bullet' | 'ordered' | 'unchecked' | 'checked';
     };
+    /**
+     * Present on task mention fragments. ClickUp renders these as live task references
+     * showing the current task name, status and assignee.
+     */
+    task_mention?: {
+        task_id: string;
+    };
     /**
      * Present on image fragments. ClickUp only renders a preview when this holds the
      * complete attachment object from the upload response - a bare URL string produces
@@ -111,6 +122,10 @@ export interface EmbeddableAttachment {
  * `title`/`text` carry the caption; the rest is copied straight from the upload response.
  */
 export declare function buildImageFragment(attachment: EmbeddableAttachment, caption: string): ClickUpCommentBlock;
+/**
+ * Extract the task ID from a ClickUp task URL, or null if it is not one.
+ */
+export declare function parseClickUpTaskUrl(url: string): string | null;
 /**
  * Wrap image destinations that contain spaces in angle brackets.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"clickup-text.d.ts","sourceRoot":"","sources":["../src/clickup-text.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"clickup-text.d.ts","sourceRoot":"","sources":["../src/clickup-text.ts"],"names":[],"mappings":"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"}

package/dist/clickup-text.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.convertClickUpTextItemsToToolCallResult = convertClickUpTextItemsToToolCallResult;
 exports.convertMarkdownToToolCallResult = convertMarkdownToToolCallResult;
 exports.buildImageFragment = buildImageFragment;
+exports.parseClickUpTaskUrl = parseClickUpTaskUrl;
 exports.normalizeImageDestinations = normalizeImageDestinations;
 exports.collectMarkdownImageSources = collectMarkdownImageSources;
 exports.rewriteMarkdownImageUrls = rewriteMarkdownImageUrls;
@@ -35,6 +36,18 @@ function extractThumbnailsFromDataAttachment(attributes) {
         return {};
     }
 }
+/**
+ * Render an image reference as markdown, escaping whatever would break the syntax.
+ *
+ * Reading and writing use the same markdown here on purpose: it lets an agent feed a
+ * comment it just read straight back into editComment without losing the images.
+ */
+function toMarkdownImage(alt, url) {
+    const safeAlt = alt.replace(/[\[\]\r\n]/g, " ").trim();
+    // Angle brackets let a URL with spaces or parentheses survive the round trip
+    const safeUrl = /[\s()]/.test(url) ? `<${url}>` : url;
+    return `![${safeAlt}](${safeUrl})`;
+}
 /**
  * Process an array of ClickUp text items into a structured content format
  * that includes both text and images in their original sequence
@@ -49,11 +62,24 @@ async function convertClickUpTextItemsToToolCallResult(textItems) {
     // Track current formatting state to avoid unnecessary close/reopen
     let activeBold = false;
     let activeItalic = false;
+    let activeStrike = false;
     let activeCode = false;
+    // ClickUp emits one '\n' fragment with a code-block attribute per code LINE;
+    // consecutive ones belong to the same fenced block when read back as markdown.
+    let inCodeBlock = false;
+    let currentFenceLang = '';
+    const closeCodeFence = () => {
+        if (inCodeBlock) {
+            currentTextBlock += '```\n';
+            inCodeBlock = false;
+            currentFenceLang = '';
+        }
+    };
     for (let i = 0; i < textItems.length; i++) {
         const item = textItems[i];
         // Handle image items
         if (item.type === "image" && item.image && item.image.url) {
+            closeCodeFence();
             const imageFileName = item.image.name || item.image.title || "image";
             const imageUrl = item.image.url;
             const altText = item.text || imageFileName;
@@ -84,8 +110,10 @@ async function convertClickUpTextItemsToToolCallResult(textItems) {
                 }
                 continue;
             }
-            // Add image URL reference inline to current text block
-            currentTextBlock += `\nImage: ${imageFileName} - ${imageUrl}`;
+            // Reference the image in the same markdown syntax the write tools accept, so a
+            // comment read here can be handed back to editComment unchanged and keep its
+            // images - an existing ClickUp attachment URL is re-embedded without re-uploading.
+            currentTextBlock += `\n${toMarkdownImage(altText, imageUrl)}`;
             // Get working thumbnail URLs from data-attachment if available
             const extractedThumbnails = extractThumbnailsFromDataAttachment(item.attributes);
             // Determine best thumbnail URLs (prefer extracted over API thumbnails)
@@ -118,6 +146,27 @@ async function convertClickUpTextItemsToToolCallResult(textItems) {
         else if (typeof item.text === "string") {
             // Check if this is a newline with block formatting (header, blockquote, list)
             if (item.text === '\n' && item.attributes) {
+                // Code block formatting: append this line to the open fence (or open one).
+                // The attribute value carries the language, either directly or nested as
+                // {'code-block': lang}; 'plain' means no language.
+                if (item.attributes['code-block']) {
+                    const rawLang = item.attributes['code-block'];
+                    const lang = typeof rawLang === 'string' ? rawLang : rawLang?.['code-block'] ?? '';
+                    const fenceLang = lang === 'plain' ? '' : lang;
+                    if (inCodeBlock && fenceLang !== currentFenceLang) {
+                        closeCodeFence();
+                    }
+                    if (!inCodeBlock) {
+                        currentTextBlock += '```' + fenceLang + '\n';
+                        inCodeBlock = true;
+                        currentFenceLang = fenceLang;
+                    }
+                    currentTextBlock += currentLine + '\n';
+                    currentLine = "";
+                    continue;
+                }
+                // Any other line terminator ends a code block
+                closeCodeFence();
                 // Header formatting
                 if (item.attributes.header) {
                     const level = item.attributes.header;
@@ -148,17 +197,8 @@ async function convertClickUpTextItemsToToolCallResult(textItems) {
                             break;
                     }
                 }
-                // Code block formatting
-                else if (item.attributes['code-block']) {
-                    // Wrap the current line in code block markers
-                    currentLine = '```\n' + currentLine + '\n```';
-                }
                 // Add formatted line to text block
-                currentTextBlock += currentLine;
-                // Add newline unless it's code block (already has newlines)
-                if (!item.attributes['code-block']) {
-                    currentTextBlock += '\n';
-                }
+                currentTextBlock += currentLine + '\n';
                 currentLine = ""; // Reset for next line
                 continue;
             }
@@ -167,15 +207,18 @@ async function convertClickUpTextItemsToToolCallResult(textItems) {
             // Determine current and next formatting state
             const hasBold = item.attributes?.bold === true;
             const hasItalic = item.attributes?.italic === true;
+            const hasStrike = item.attributes?.strike === true;
             const hasLink = item.attributes?.link;
             // Look ahead to next non-newline block
             let nextHasBold = false;
             let nextHasItalic = false;
+            let nextHasStrike = false;
             for (let j = i + 1; j < textItems.length; j++) {
                 const nextItem = textItems[j];
                 if (nextItem.text !== '\n' || !nextItem.attributes) {
                     nextHasBold = nextItem.attributes?.bold === true;
                     nextHasItalic = nextItem.attributes?.italic === true;
+                    nextHasStrike = nextItem.attributes?.strike === true;
                     break;
                 }
             }
@@ -185,14 +228,20 @@ async function convertClickUpTextItemsToToolCallResult(textItems) {
                 prefix += "**";
             if (hasItalic && !activeItalic)
                 prefix += "*";
+            if (hasStrike && !activeStrike)
+                prefix += "~~";
             // Build suffix (close formatting that won't continue)
             let suffix = "";
+            if (hasStrike && !nextHasStrike)
+                suffix += "~~";
             if (hasItalic && !nextHasItalic)
                 suffix += "*";
             if (hasBold && !nextHasBold)
                 suffix += "**";
             // Close formatting that's active but not in this block
             let closingPrefix = "";
+            if (activeStrike && !hasStrike)
+                closingPrefix += "~~";
             if (activeBold && !hasBold)
                 closingPrefix += "**";
             if (activeItalic && !hasItalic)
@@ -201,6 +250,7 @@ async function convertClickUpTextItemsToToolCallResult(textItems) {
             // Update state
             activeBold = hasBold && nextHasBold;
             activeItalic = hasItalic && nextHasItalic;
+            activeStrike = hasStrike && nextHasStrike;
             // Link formatting (wraps everything)
             if (hasLink) {
                 formattedText = `[${formattedText}](${hasLink})`;
@@ -212,6 +262,7 @@ async function convertClickUpTextItemsToToolCallResult(textItems) {
             // Add to current line (not text block yet)
             if (item.text === '\n') {
                 // Plain newline without formatting
+                closeCodeFence();
                 currentTextBlock += currentLine + '\n';
                 currentLine = "";
             }
@@ -219,12 +270,18 @@ async function convertClickUpTextItemsToToolCallResult(textItems) {
                 currentLine += formattedText;
             }
         }
+        // Task mentions render as the task URL so the reference survives the round trip:
+        // writing that URL back through addComment/editComment regenerates the mention.
+        else if (item.type === "task_mention" && item.task_mention?.task_id) {
+            currentLine += `https://app.clickup.com/t/${item.task_mention.task_id}`;
+        }
         // Handle other types of items like bookmarks or whatever clickup can think of
         else {
             currentTextBlock += JSON.stringify(item);
         }
     }
     // Add any remaining text
+    closeCodeFence();
     if (currentLine) {
         currentTextBlock += currentLine;
     }
@@ -292,9 +349,9 @@ function convertMarkdownToToolCallResult(markdownText, attachments) {
         // Check if this image URL exists in our attachments
         const attachment = attachmentMap.get(imageUrl);
         if (attachment) {
-            // Add image URL reference inline to current text block
+            // Keep the markdown syntax, so the reference stays usable in a write call
             const imageFileName = altText || "image";
-            currentTextBlock += `\nImage: ${imageFileName} - ${imageUrl}`;
+            currentTextBlock += `\n${toMarkdownImage(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
@@ -411,6 +468,22 @@ function buildImageFragment(attachment, caption) {
     }
     return fragment;
 }
+/**
+ * Matches a plain ClickUp task URL, with or without the team segment:
+ * https://app.clickup.com/t/86cb3t6t2 or https://app.clickup.com/t/4500611/86cb3t6t2
+ *
+ * Deliberately narrow: custom task IDs (PREFIX-123) and URLs carrying a query or
+ * fragment (e.g. ?comment=... deep links) do NOT match, because a mention would
+ * either not resolve or lose the anchor - those stay ordinary links.
+ */
+const CLICKUP_TASK_URL_PATTERN = /^https?:\/\/app\.clickup\.com\/t\/(?:\d+\/)?([a-z0-9]{6,16})\/?$/;
+/**
+ * Extract the task ID from a ClickUp task URL, or null if it is not one.
+ */
+function parseClickUpTaskUrl(url) {
+    const match = url.match(CLICKUP_TASK_URL_PATTERN);
+    return match ? match[1] : null;
+}
 /**
  * Wrap image destinations that contain spaces in angle brackets.
  *
@@ -585,25 +658,119 @@ function walkMdastNodes(nodes, inheritedAttrs, blocks, depth = 0, attachmentsByS
                 // Code block
                 const codeNode = node;
                 if (codeNode.value) {
-                    blocks.push({ text: codeNode.value, attributes: {} });
-                    blocks.push({
-                        text: '\n',
-                        attributes: { 'code-block': { 'code-block': codeNode.lang || 'plain' } }
-                    });
+                    pushCodeBlockLines(blocks, codeNode.value, codeNode.lang || 'plain');
                 }
                 break;
             case 'thematicBreak':
                 // Horizontal rule - just add a line break
                 blocks.push({ text: '\n', attributes: {} });
                 break;
+            case 'table': {
+                // ClickUp comments cannot render tables (there is no table fragment in the
+                // comment format - unknown attributes are stored but render as plain text).
+                // Re-render the table as an aligned pipe table inside a code block so the
+                // information survives and stays readable in monospace.
+                const tableText = serializeTableAsAlignedPipes(node);
+                if (tableText) {
+                    pushCodeBlockLines(blocks, tableText, 'plain');
+                }
+                break;
+            }
             default:
                 // For any other block-level nodes, try to process children
                 if ('children' in node && Array.isArray(node.children)) {
                     walkMdastNodes(node.children, currentAttrs, blocks, depth, attachmentsBySrc);
                 }
+                else if ('value' in node && typeof node.value === 'string') {
+                    // Last-resort safety net: never drop text content silently
+                    blocks.push({ text: node.value, attributes: {} });
+                }
+                break;
+        }
+    }
+}
+/**
+ * Emit a (possibly multi-line) code block the way ClickUp's Quill-based format
+ * expects it: block attributes apply per line, so EVERY line needs its own '\n'
+ * fragment carrying the code-block attribute. A single text fragment with embedded
+ * newlines renders only its last line as code - the rest degrades to plain text.
+ */
+function pushCodeBlockLines(blocks, code, lang) {
+    for (const line of code.split('\n')) {
+        if (line) {
+            blocks.push({ text: line, attributes: {} });
+        }
+        blocks.push({
+            text: '\n',
+            attributes: { 'code-block': { 'code-block': lang } }
+        });
+    }
+}
+/**
+ * Serialize phrasing content back to compact markdown for use inside a code block.
+ * Inline formatting markers are kept so nothing is lost, even though a code block
+ * renders them literally.
+ */
+function serializePhrasingToMarkdown(nodes) {
+    let out = '';
+    for (const node of nodes) {
+        switch (node.type) {
+            case 'text':
+                out += node.value;
+                break;
+            case 'strong':
+                out += `**${serializePhrasingToMarkdown(node.children)}**`;
+                break;
+            case 'emphasis':
+                out += `*${serializePhrasingToMarkdown(node.children)}*`;
+                break;
+            case 'delete':
+                out += `~~${serializePhrasingToMarkdown(node.children)}~~`;
+                break;
+            case 'inlineCode':
+                out += `\`${node.value}\``;
+                break;
+            case 'link':
+                out += `[${serializePhrasingToMarkdown(node.children)}](${node.url})`;
+                break;
+            case 'image':
+                out += node.alt || node.url;
+                break;
+            case 'break':
+                out += ' ';
+                break;
+            default:
+                if ('value' in node && typeof node.value === 'string') {
+                    out += node.value;
+                }
+                else if ('children' in node && Array.isArray(node.children)) {
+                    out += serializePhrasingToMarkdown(node.children);
+                }
                 break;
         }
     }
+    return out;
+}
+/**
+ * Render an mdast table as a column-aligned pipe table string.
+ */
+function serializeTableAsAlignedPipes(table) {
+    const rows = table.children.map((row) => row.children.map((cell) => serializePhrasingToMarkdown(cell.children).replace(/\|/g, '\\|').trim()));
+    if (rows.length === 0) {
+        return '';
+    }
+    const colCount = Math.max(...rows.map((r) => r.length));
+    const widths = [];
+    for (let col = 0; col < colCount; col++) {
+        widths[col] = Math.max(3, ...rows.map((r) => (r[col] ?? '').length));
+    }
+    const renderRow = (cells) => '| ' + widths.map((w, col) => (cells[col] ?? '').padEnd(w)).join(' | ') + ' |';
+    const lines = [renderRow(rows[0])];
+    lines.push('| ' + widths.map((w) => '-'.repeat(w)).join(' | ') + ' |');
+    for (const row of rows.slice(1)) {
+        lines.push(renderRow(row));
+    }
+    return lines.join('\n');
 }
 /**
  * Recursively walk phrasing content (inline nodes) and build ClickUp blocks
@@ -652,6 +819,11 @@ function walkPhrasingContent(nodes, inheritedAttrs, blocks, attachmentsBySrc) {
                 currentAttrs.italic = true;
                 walkPhrasingContent(node.children, currentAttrs, blocks, attachmentsBySrc);
                 break;
+            case 'delete':
+                // GFM strikethrough (~~text~~) - ClickUp renders this via the strike attribute
+                currentAttrs.strike = true;
+                walkPhrasingContent(node.children, currentAttrs, blocks, attachmentsBySrc);
+                break;
             case 'inlineCode':
                 // Inline code
                 if (node.value) {
@@ -662,11 +834,20 @@ function walkPhrasingContent(nodes, inheritedAttrs, blocks, attachmentsBySrc) {
                     });
                 }
                 break;
-            case 'link':
-                // Link - recurse with link attribute
+            case 'link': {
+                // A link to a ClickUp task becomes a real task mention, matching what the
+                // ClickUp UI does when a task URL is pasted. The mention renders the live
+                // task name, so any custom link text is intentionally replaced by it.
+                const mentionedTaskId = parseClickUpTaskUrl(node.url);
+                if (mentionedTaskId) {
+                    blocks.push({ type: 'task_mention', task_mention: { task_id: mentionedTaskId } });
+                    break;
+                }
+                // Ordinary link - recurse with link attribute
                 currentAttrs.link = node.url;
                 walkPhrasingContent(node.children, currentAttrs, blocks, attachmentsBySrc);
                 break;
+            }
             case 'break':
                 // Line break - add as plain text
                 blocks.push({ text: '\n', attributes: {} });

package/dist/shared/attachments.d.ts

@@ -61,31 +61,52 @@ export declare function captionToFilename(caption: string, fallbackName: string)
  * Upload a single image to a task and return the full attachment object.
  */
 export declare function uploadTaskAttachment(taskId: string, filename: string, bytes: Buffer, mimeType: string): Promise<ClickUpUploadedAttachment>;
-/** One markdown image reference and what became of it */
-export interface ImageUploadResult {
+/** A markdown image whose source resolved to uploadable bytes or an existing attachment */
+export interface ResolvedMarkdownImage {
     /** The original `src` as written in the markdown */
     src: string;
-    /** Attachment to embed, or null when the upload failed */
-    attachment: ClickUpUploadedAttachment | null;
-    /** Reason the upload failed, for reporting back to the caller */
-    error?: string;
+    alt: string;
+    resolved: ResolvedImageSource;
+}
+/** One markdown image reference that could not be used, and why */
+export interface ImageFailure {
+    src: string;
+    error: string;
 }
 /**
- * Upload every image referenced in the markdown to the given task.
+ * Phase 1 of attaching images: resolve every source without writing anything.
  *
- * Uploads run sequentially: a typical comment has a handful of screenshots, and
- * N uploads plus one write call stays well inside ClickUp's 100 calls/minute.
- * A failing image never fails the whole batch - the caller writes the comment
- * anyway and reports which images did not make it.
+ * Reads local files, downloads http(s) URLs, decodes data URIs and validates
+ * magic bytes and size. Failures are collected instead of thrown so the caller
+ * can report every broken reference at once - and abort before anything is
+ * posted to ClickUp. Identical sources are resolved once.
  */
-export declare function uploadMarkdownImages(taskId: string, images: {
+export declare function resolveMarkdownImages(images: {
     src: string;
     alt: string;
-}[], baseDir?: string): Promise<ImageUploadResult[]>;
+}[], baseDir?: string): Promise<{
+    resolved: ResolvedMarkdownImage[];
+    failures: ImageFailure[];
+}>;
+/** A successfully uploaded (or reused) attachment for one markdown source */
+export interface UploadedMarkdownImage {
+    src: string;
+    attachment: ClickUpUploadedAttachment;
+}
 /**
- * Map from markdown `src` to the attachment that should be embedded for it.
- * Sources whose upload failed are absent, so the converters fall back to text.
+ * Phase 2: upload the resolved images to the task.
+ *
+ * Uploads run sequentially: a typical comment has a handful of screenshots, and
+ * N uploads plus one write call stays well inside ClickUp's 100 calls/minute.
+ * Stops at the first upload error - an API failure is unlikely to heal mid-batch,
+ * and everything uploaded so far is returned so the caller can tell a retry to
+ * reference those CDN URLs directly instead of uploading again.
  */
-export declare function toAttachmentMap(results: ImageUploadResult[]): Map<string, ClickUpUploadedAttachment>;
+export declare function uploadResolvedImages(taskId: string, images: ResolvedMarkdownImage[]): Promise<{
+    uploaded: UploadedMarkdownImage[];
+    failure: ImageFailure | null;
+}>;
+/** Map from markdown `src` to the attachment that should be embedded for it. */
+export declare function toAttachmentMap(uploaded: UploadedMarkdownImage[]): Map<string, ClickUpUploadedAttachment>;
 export {};
 //# sourceMappingURL=attachments.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/shared/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQhC;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,uCAAuC;AACvC,UAAU,aAAa;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,mFAAmF;AACnF,UAAU,gBAAgB;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAoCnE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAM3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAsB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CA2C9B;AAcD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAS/E;AAmCD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,yBAAyB,CAAC,CAwBpC;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,UAAU,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC7C,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,EACtC,OAAO,GAAE,MAAsB,GAC9B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqD9B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,iBAAiB,EAAE,GAC3B,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAQxC"}
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/shared/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQhC;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,uCAAuC;AACvC,UAAU,aAAa;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,mFAAmF;AACnF,UAAU,gBAAgB;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAoCnE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAM3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAsB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CA2C9B;AAcD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAS/E;AAmCD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,yBAAyB,CAAC,CAwBpC;AAED,2FAA2F;AAC3F,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,EACtC,OAAO,GAAE,MAAsB,GAC9B,OAAO,CAAC;IAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CAqB1E;AAED,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,yBAAyB,CAAC;CACvC;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,qBAAqB,EAAE,GAC9B,OAAO,CAAC;IAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,CAAC,CAwC9E;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,qBAAqB,EAAE,GAChC,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAMxC"}