@griffinwork40/clickup-mcp-server 1.1.4 → 1.1.6

package/dist/utils/formatters/entities.js

@@ -0,0 +1,146 @@
+/**
+ * Entity formatters for ClickUp MCP server.
+ * Format ClickUp entities (tasks, lists, spaces, etc.) as markdown.
+ */
+import { formatDate, formatPriority } from "./base.js";
+/**
+ * Format a task as markdown (full detail)
+ */
+export function formatTaskMarkdown(task) {
+    const lines = [];
+    lines.push(`# ${task.name} (${task.id})`);
+    lines.push("");
+    lines.push(`**Status**: ${task.status.status}`);
+    lines.push(`**Priority**: ${formatPriority(task.priority)}`);
+    lines.push(`**Created**: ${formatDate(task.date_created)}`);
+    lines.push(`**Updated**: ${formatDate(task.date_updated)}`);
+    if (task.due_date) {
+        lines.push(`**Due Date**: ${formatDate(task.due_date)}`);
+    }
+    if (task.assignees && task.assignees.length > 0) {
+        const assigneeNames = task.assignees.map(a => `@${a.username} (${a.id})`).join(", ");
+        lines.push(`**Assignees**: ${assigneeNames}`);
+    }
+    if (task.tags && task.tags.length > 0) {
+        const tagNames = task.tags.map(t => t.name).join(", ");
+        lines.push(`**Tags**: ${tagNames}`);
+    }
+    if (task.description) {
+        lines.push("");
+        lines.push("## Description");
+        lines.push(task.description);
+    }
+    lines.push("");
+    lines.push(`**URL**: ${task.url}`);
+    return lines.join("\n");
+}
+/**
+ * Format a task as compact markdown (essential fields only)
+ */
+export function formatTaskCompact(task) {
+    const assignees = task.assignees && task.assignees.length > 0
+        ? task.assignees.map(a => a.username).join(", ")
+        : "Unassigned";
+    return `- **${task.name}** (${task.id}) | Status: ${task.status.status} | Assignees: ${assignees} | URL: ${task.url}`;
+}
+/**
+ * Format a list as markdown
+ */
+export function formatListMarkdown(list) {
+    const lines = [];
+    lines.push(`# ${list.name} (${list.id})`);
+    lines.push("");
+    lines.push(`**Tasks**: ${list.task_count}`);
+    if (list.folder) {
+        lines.push(`**Folder**: ${list.folder.name}`);
+    }
+    if (list.space) {
+        lines.push(`**Space**: ${list.space.name}`);
+    }
+    if (list.statuses && list.statuses.length > 0) {
+        lines.push("");
+        lines.push("## Statuses");
+        for (const status of list.statuses) {
+            lines.push(`- ${status.status} (${status.type})`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a space as markdown
+ */
+export function formatSpaceMarkdown(space) {
+    const lines = [];
+    lines.push(`# ${space.name} (${space.id})`);
+    lines.push("");
+    lines.push(`**Private**: ${space.private ? "Yes" : "No"}`);
+    lines.push(`**Multiple Assignees**: ${space.multiple_assignees ? "Yes" : "No"}`);
+    if (space.features) {
+        lines.push("");
+        lines.push("## Features");
+        lines.push(`- Due Dates: ${space.features.due_dates?.enabled ? "Enabled" : "Disabled"}`);
+        lines.push(`- Time Tracking: ${space.features.time_tracking?.enabled ? "Enabled" : "Disabled"}`);
+        lines.push(`- Tags: ${space.features.tags?.enabled ? "Enabled" : "Disabled"}`);
+        lines.push(`- Custom Fields: ${space.features.custom_fields?.enabled ? "Enabled" : "Disabled"}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a folder as markdown
+ */
+export function formatFolderMarkdown(folder) {
+    const lines = [];
+    lines.push(`# ${folder.name} (${folder.id})`);
+    lines.push("");
+    lines.push(`**Tasks**: ${folder.task_count}`);
+    lines.push(`**Hidden**: ${folder.hidden ? "Yes" : "No"}`);
+    if (folder.space) {
+        lines.push(`**Space**: ${folder.space.name}`);
+    }
+    if (folder.lists && folder.lists.length > 0) {
+        lines.push("");
+        lines.push("## Lists");
+        for (const list of folder.lists) {
+            lines.push(`- ${list.name} (${list.id}) - ${list.task_count} tasks`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a comment as markdown
+ */
+export function formatCommentMarkdown(comment) {
+    const lines = [];
+    lines.push(`**@${comment.user.username}** (${formatDate(comment.date)})`);
+    lines.push(comment.comment_text);
+    if (comment.resolved) {
+        lines.push("*(Resolved)*");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a time entry as markdown
+ */
+export function formatTimeEntryMarkdown(entry) {
+    const lines = [];
+    const hours = Math.floor(parseInt(entry.duration) / 3600000);
+    const minutes = Math.floor((parseInt(entry.duration) % 3600000) / 60000);
+    const durationStr = `${hours}h ${minutes}m`;
+    lines.push(`**@${entry.user.username}** - ${durationStr}`);
+    lines.push(`- Start: ${formatDate(entry.start)}`);
+    if (entry.end) {
+        lines.push(`- End: ${formatDate(entry.end)}`);
+    }
+    else {
+        lines.push("- End: *(Still running)*");
+    }
+    if (entry.task) {
+        lines.push(`- Task: ${entry.task.name} (${entry.task.id})`);
+    }
+    if (entry.description) {
+        lines.push(`- Description: ${entry.description}`);
+    }
+    lines.push(`- Billable: ${entry.billable ? "Yes" : "No"}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=entities.js.map

package/dist/utils/formatters/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../../src/utils/formatters/entities.ts"],"names":[],"mappings":"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"}

package/dist/utils/formatters/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Barrel export for formatter utilities.
+ */
+export { formatDate, formatPriority, formatTruncationInfo } from "./base.js";
+export { formatTaskMarkdown, formatTaskCompact, formatListMarkdown, formatSpaceMarkdown, formatFolderMarkdown, formatCommentMarkdown, formatTimeEntryMarkdown } from "./entities.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/formatters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/formatters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,EACV,cAAc,EACd,oBAAoB,EACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,eAAe,CAAC"}

package/dist/utils/formatters/index.js

@@ -0,0 +1,6 @@
+/**
+ * Barrel export for formatter utilities.
+ */
+export { formatDate, formatPriority, formatTruncationInfo } from "./base.js";
+export { formatTaskMarkdown, formatTaskCompact, formatListMarkdown, formatSpaceMarkdown, formatFolderMarkdown, formatCommentMarkdown, formatTimeEntryMarkdown } from "./entities.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/formatters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/formatters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,EACV,cAAc,EACd,oBAAoB,EACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,eAAe,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Barrel export for all utility modules.
+ * Re-exports all utilities from their respective modules.
+ */
+export { getApiToken, makeApiRequest, handleApiError } from "./api-client.js";
+export { formatDate, formatPriority, formatTruncationInfo, formatTaskMarkdown, formatTaskCompact, formatListMarkdown, formatSpaceMarkdown, formatFolderMarkdown, formatCommentMarkdown, formatTimeEntryMarkdown } from "./formatters/index.js";
+export { truncateResponse } from "./truncation.js";
+export { generateTaskSummary, filterTasksByStatus } from "./task-analytics.js";
+export { countTasksByStatus, type CountTasksOptions, type CountTasksResult } from "./task-counter.js";
+export { normalizePhoneToE164, extractCustomFieldValue, getCustomField } from "./custom-fields.js";
+export { escapeCSV, taskToCSVRow, exportTasksToCSV, type ExportCSVOptions } from "./csv-export.js";
+export { getPagination } from "./data-processing.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,WAAW,EACX,cAAc,EACd,cAAc,EACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,21 @@
+/**
+ * Barrel export for all utility modules.
+ * Re-exports all utilities from their respective modules.
+ */
+// API client
+export { getApiToken, makeApiRequest, handleApiError } from "./api-client.js";
+// Formatters
+export { formatDate, formatPriority, formatTruncationInfo, formatTaskMarkdown, formatTaskCompact, formatListMarkdown, formatSpaceMarkdown, formatFolderMarkdown, formatCommentMarkdown, formatTimeEntryMarkdown } from "./formatters/index.js";
+// Truncation
+export { truncateResponse } from "./truncation.js";
+// Task analytics
+export { generateTaskSummary, filterTasksByStatus } from "./task-analytics.js";
+// Task counting
+export { countTasksByStatus } from "./task-counter.js";
+// Custom fields
+export { normalizePhoneToE164, extractCustomFieldValue, getCustomField } from "./custom-fields.js";
+// CSV export
+export { escapeCSV, taskToCSVRow, exportTasksToCSV } from "./csv-export.js";
+// Data processing
+export { getPagination } from "./data-processing.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,aAAa;AACb,OAAO,EACL,WAAW,EACX,cAAc,EACd,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,aAAa;AACb,OAAO,EACL,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,gBAAgB;AAChB,OAAO,EACL,kBAAkB,EAGnB,MAAM,mBAAmB,CAAC;AAE3B,gBAAgB;AAChB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B,aAAa;AACb,OAAO,EACL,SAAS,EACT,YAAY,EACZ,gBAAgB,EAEjB,MAAM,iBAAiB,CAAC;AAEzB,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/utils/task-analytics.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Task analytics utilities for ClickUp MCP server.
+ * Generate statistics and filter tasks.
+ */
+import type { ClickUpTask } from "../types.js";
+/**
+ * Generate summary statistics for a list of tasks
+ */
+export declare function generateTaskSummary(tasks: ClickUpTask[]): string;
+/**
+ * Filter tasks by status names (client-side filtering)
+ */
+export declare function filterTasksByStatus(tasks: ClickUpTask[], statuses: string[]): ClickUpTask[];
+//# sourceMappingURL=task-analytics.d.ts.map

package/dist/utils/task-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-analytics.d.ts","sourceRoot":"","sources":["../../src/utils/task-analytics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAqDhE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAS3F"}

package/dist/utils/task-analytics.js

@@ -0,0 +1,67 @@
+/**
+ * Task analytics utilities for ClickUp MCP server.
+ * Generate statistics and filter tasks.
+ */
+import { formatPriority } from "./formatters/base.js";
+/**
+ * Generate summary statistics for a list of tasks
+ */
+export function generateTaskSummary(tasks) {
+    const lines = [];
+    lines.push("# Task Summary");
+    lines.push("");
+    lines.push(`**Total Tasks**: ${tasks.length}`);
+    lines.push("");
+    // Group by status
+    const statusCounts = {};
+    const assigneeCounts = {};
+    const priorityCounts = {};
+    for (const task of tasks) {
+        // Count statuses
+        const status = task.status.status;
+        statusCounts[status] = (statusCounts[status] || 0) + 1;
+        // Count assignees
+        if (task.assignees && task.assignees.length > 0) {
+            for (const assignee of task.assignees) {
+                assigneeCounts[assignee.username] = (assigneeCounts[assignee.username] || 0) + 1;
+            }
+        }
+        else {
+            assigneeCounts["Unassigned"] = (assigneeCounts["Unassigned"] || 0) + 1;
+        }
+        // Count priorities
+        const priority = formatPriority(task.priority);
+        priorityCounts[priority] = (priorityCounts[priority] || 0) + 1;
+    }
+    // Format status breakdown
+    lines.push("## By Status");
+    for (const [status, count] of Object.entries(statusCounts).sort((a, b) => b[1] - a[1])) {
+        lines.push(`- ${status}: ${count}`);
+    }
+    // Format assignee breakdown
+    lines.push("");
+    lines.push("## By Assignee");
+    for (const [assignee, count] of Object.entries(assigneeCounts).sort((a, b) => b[1] - a[1])) {
+        lines.push(`- ${assignee}: ${count}`);
+    }
+    // Format priority breakdown
+    lines.push("");
+    lines.push("## By Priority");
+    for (const [priority, count] of Object.entries(priorityCounts).sort((a, b) => b[1] - a[1])) {
+        lines.push(`- ${priority}: ${count}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Filter tasks by status names (client-side filtering)
+ */
+export function filterTasksByStatus(tasks, statuses) {
+    if (!statuses || statuses.length === 0) {
+        return tasks;
+    }
+    return tasks.filter(task => {
+        const taskStatus = task.status?.status;
+        return taskStatus && statuses.includes(taskStatus);
+    });
+}
+//# sourceMappingURL=task-analytics.js.map

package/dist/utils/task-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-analytics.js","sourceRoot":"","sources":["../../src/utils/task-analytics.ts"],"names":[],"mappings":"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"}

package/dist/utils/task-counter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Task counting utilities for ClickUp MCP server.
+ * Count tasks by status with pagination handling.
+ */
+/**
+ * Options for counting tasks by status
+ */
+export interface CountTasksOptions {
+    archived?: boolean;
+    include_closed?: boolean;
+    statuses?: string[];
+}
+/**
+ * Result of counting tasks by status
+ */
+export interface CountTasksResult {
+    total: number;
+    by_status: Record<string, number>;
+}
+/**
+ * Count tasks in a list by status, handling pagination internally
+ */
+export declare function countTasksByStatus(listId: string, options?: CountTasksOptions): Promise<CountTasksResult>;
+//# sourceMappingURL=task-counter.d.ts.map

package/dist/utils/task-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-counter.d.ts","sourceRoot":"","sources":["../../src/utils/task-counter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAmD3B"}

package/dist/utils/task-counter.js

@@ -0,0 +1,52 @@
+/**
+ * Task counting utilities for ClickUp MCP server.
+ * Count tasks by status with pagination handling.
+ */
+import { MAX_LIMIT } from "../constants.js";
+import { makeApiRequest } from "./api-client.js";
+import { filterTasksByStatus } from "./task-analytics.js";
+/**
+ * Count tasks in a list by status, handling pagination internally
+ */
+export async function countTasksByStatus(listId, options = {}) {
+    const { archived = false, include_closed = false, statuses } = options;
+    const limit = MAX_LIMIT; // Use max limit for efficiency
+    let offset = 0;
+    let allTasks = [];
+    let hasMore = true;
+    // Fetch all tasks with pagination
+    while (hasMore) {
+        const queryParams = {
+            archived,
+            include_closed,
+            page: Math.floor(offset / limit),
+            limit: limit // FIX: Actually send limit to API
+        };
+        try {
+            const data = await makeApiRequest(`list/${listId}/task`, "GET", undefined, queryParams);
+            const tasks = data.tasks || [];
+            allTasks.push(...tasks);
+            hasMore = tasks.length === limit;
+            offset += limit;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    // Filter by status if specified
+    let filteredTasks = allTasks;
+    if (statuses && statuses.length > 0) {
+        filteredTasks = filterTasksByStatus(allTasks, statuses);
+    }
+    // Count by status
+    const byStatus = {};
+    for (const task of filteredTasks) {
+        const status = task.status?.status || "Unknown";
+        byStatus[status] = (byStatus[status] || 0) + 1;
+    }
+    return {
+        total: filteredTasks.length,
+        by_status: byStatus
+    };
+}
+//# sourceMappingURL=task-counter.js.map

package/dist/utils/task-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-counter.js","sourceRoot":"","sources":["../../src/utils/task-counter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAmB1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,UAA6B,EAAE;IAE/B,MAAM,EAAE,QAAQ,GAAG,KAAK,EAAE,cAAc,GAAG,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACvE,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,+BAA+B;IACxD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAkB,EAAE,CAAC;IACjC,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,kCAAkC;IAClC,OAAO,OAAO,EAAE,CAAC;QACf,MAAM,WAAW,GAAQ;YACvB,QAAQ;YACR,cAAc;YACd,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YAChC,KAAK,EAAE,KAAK,CAAE,kCAAkC;SACjD,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,cAAc,CAC/B,QAAQ,MAAM,OAAO,EACrB,KAAK,EACL,SAAS,EACT,WAAW,CACZ,CAAC;YAEF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YAExB,OAAO,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,IAAI,aAAa,GAAG,QAAQ,CAAC;IAC7B,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,aAAa,GAAG,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED,kBAAkB;IAClB,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,SAAS,CAAC;QAChD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACL,KAAK,EAAE,aAAa,CAAC,MAAM;QAC3B,SAAS,EAAE,QAAQ;KACpB,CAAC;AACJ,CAAC"}

package/dist/utils/truncation.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Response truncation utilities for ClickUp MCP server.
+ * Smart response size management with format detection.
+ */
+import type { TruncationInfo } from "../types.js";
+/**
+ * Truncate response if it exceeds character limit with smart boundary detection
+ * Detects format and uses appropriate truncation strategy
+ */
+export declare function truncateResponse(content: string, itemCount: number, itemType?: string): {
+    content: string;
+    truncation: TruncationInfo | null;
+};
+//# sourceMappingURL=truncation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.d.ts","sourceRoot":"","sources":["../../src/utils/truncation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA+HlD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAgB,GACzB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,CAYxD"}

package/dist/utils/truncation.js

@@ -0,0 +1,124 @@
+/**
+ * Response truncation utilities for ClickUp MCP server.
+ * Smart response size management with format detection.
+ */
+import { CHARACTER_LIMIT } from "../constants.js";
+/**
+ * Truncate JSON response by removing items from arrays
+ */
+function truncateJsonResponse(content, itemCount, itemType = "items") {
+    try {
+        const data = JSON.parse(content);
+        // Find the main array (tasks, conversations, etc.)
+        const arrayKey = Object.keys(data).find(key => Array.isArray(data[key]));
+        if (!arrayKey || !Array.isArray(data[arrayKey])) {
+            // If no array found, fall back to string truncation
+            throw new Error('No array found in JSON');
+        }
+        const items = data[arrayKey];
+        let keptItems = items.length;
+        // Remove items one by one until we're under the limit
+        // IMPORTANT: Check size of PRETTY-PRINTED JSON since that's what we return
+        while (JSON.stringify(data, null, 2).length > CHARACTER_LIMIT && data[arrayKey].length > 1) {
+            data[arrayKey].pop();
+            keptItems = data[arrayKey].length;
+        }
+        const finalContent = JSON.stringify(data, null, 2);
+        // Check if even a single item exceeds the limit
+        if (finalContent.length > CHARACTER_LIMIT) {
+            // Single item is too large - truncate the item's description/content fields
+            if (data[arrayKey].length === 1 && typeof data[arrayKey][0] === 'object') {
+                const item = data[arrayKey][0];
+                // Truncate large text fields
+                for (const key of Object.keys(item)) {
+                    if (typeof item[key] === 'string' && item[key].length > 10000) {
+                        item[key] = item[key].substring(0, 10000) + '... [truncated]';
+                    }
+                }
+                // Retry serialization
+                const compactContent = JSON.stringify(data, null, 2);
+                if (compactContent.length <= CHARACTER_LIMIT) {
+                    const truncation = {
+                        truncated: true,
+                        original_count: itemCount,
+                        returned_count: 1,
+                        truncation_message: `Large ${itemType} fields were truncated to fit size limits (${CHARACTER_LIMIT.toLocaleString()} chars).`
+                    };
+                    return { content: compactContent, truncation };
+                }
+            }
+            // Still too large - fall back to markdown truncation
+            return truncateMarkdownResponse(content, itemCount, itemType);
+        }
+        if (keptItems < items.length) {
+            const truncation = {
+                truncated: true,
+                original_count: items.length,
+                returned_count: keptItems,
+                truncation_message: `Response truncated from ${items.length} to ${keptItems} ${itemType} due to size limits (${CHARACTER_LIMIT.toLocaleString()} chars). Use pagination (offset/limit), add filters, or use response_mode='compact' to see more results.`
+            };
+            return { content: finalContent, truncation };
+        }
+        return { content: finalContent, truncation: null };
+    }
+    catch {
+        // If JSON parsing fails, fall back to string truncation
+        return truncateMarkdownResponse(content, itemCount, itemType);
+    }
+}
+/**
+ * Truncate markdown response if it exceeds character limit with smart boundary detection
+ */
+function truncateMarkdownResponse(content, itemCount, itemType = "items") {
+    if (content.length <= CHARACTER_LIMIT) {
+        return { content, truncation: null };
+    }
+    // Find a good boundary to truncate at (look for task separators or major section breaks)
+    let truncateAt = CHARACTER_LIMIT;
+    const searchStart = Math.max(0, CHARACTER_LIMIT - 1000); // Look back up to 1000 chars
+    // Look for markdown headers or horizontal rules as good break points
+    const potentialBreaks = [
+        content.lastIndexOf("\n# ", truncateAt),
+        content.lastIndexOf("\n## ", truncateAt),
+        content.lastIndexOf("\n---\n", truncateAt),
+        content.lastIndexOf("\n\n", truncateAt)
+    ].filter(pos => pos >= searchStart);
+    if (potentialBreaks.length > 0) {
+        truncateAt = Math.max(...potentialBreaks);
+    }
+    else {
+        // Fallback to last newline
+        const lastNewline = content.lastIndexOf("\n", CHARACTER_LIMIT);
+        if (lastNewline > searchStart) {
+            truncateAt = lastNewline;
+        }
+    }
+    const finalContent = content.substring(0, truncateAt);
+    // Count how many complete items we kept by counting separators/headers
+    const headerPattern = /^# .+ \(/gm;
+    const keptItems = (finalContent.match(headerPattern) || []).length ||
+        Math.max(1, Math.floor(itemCount * (truncateAt / content.length)));
+    const truncation = {
+        truncated: true,
+        original_count: itemCount,
+        returned_count: keptItems,
+        truncation_message: `Response truncated from ${itemCount} to ${keptItems} ${itemType} due to size limits (${CHARACTER_LIMIT.toLocaleString()} chars). Use pagination (offset/limit), add filters, or use response_mode='compact' to see more results.`
+    };
+    return { content: finalContent, truncation };
+}
+/**
+ * Truncate response if it exceeds character limit with smart boundary detection
+ * Detects format and uses appropriate truncation strategy
+ */
+export function truncateResponse(content, itemCount, itemType = "items") {
+    if (content.length <= CHARACTER_LIMIT) {
+        return { content, truncation: null };
+    }
+    // Detect if content is JSON by checking first non-whitespace character
+    const trimmed = content.trimStart();
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        return truncateJsonResponse(content, itemCount, itemType);
+    }
+    return truncateMarkdownResponse(content, itemCount, itemType);
+}
+//# sourceMappingURL=truncation.js.map

package/dist/utils/truncation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@griffinwork40/clickup-mcp-server",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "MCP server for ClickUp API integration - manage tasks, projects, and workflows",
   "type": "module",
   "main": "dist/index.js",